[ruby-core:64930] [ruby-trunk - Bug #10161] C API docs not generated properly without baseruby

Issue #10161 has been updated by Tomoyuki Chikanaga.

Backport changed from 2.0.0: REQUIRED, 2.1: REQUIRED to 2.0.0: REQUIRED, 2.1: DONE

Backported into `ruby_2_1` branch at r47518.

----------------------------------------
Bug #10161: C API docs not generated properly without baseruby
https://bugs.ruby-lang.org/issues/10161#change-48822

* Author: Steve Wills
* Status: Closed
* Priority: Normal
* Assignee: 
* Category: 
* Target version: 
* ruby -v: ruby 2.0.0p481 (2014-05-08 revision 45883) [amd64-freebsd11]
* Backport: 2.0.0: REQUIRED, 2.1: DONE
----------------------------------------
In 1.9.x, the C API docs would be generated properly even if you didn't have ruby installed first. However, this has changed in 2.0.0 and 2.1.x.

Because lines 44-50 of configure.in expect baseruby to exist or set it to "echo executable host ruby is required....", I think the lines at the top of template/Doxyfile.tmpl don't work and so you end up with FILE_VERSION_FILTER and INPUT_FILTER set to "echo executable host ruby is required....", which causes the doxygen docs to be generated without the "Modules" and "Data Structures" tabs. This makes the docs far less useful.

In 1.9.x, baseruby isn't checked to exist at build time, FILE_VERSION_FILTER and INPUT_FILTER end up set to miniruby and all works fine.

There are several ways to fix this, either changing configure.in, changing template/Doxyfile.tmpl etc.



-- 
https://bugs.ruby-lang.org/