[ruby-core:69351] [Ruby trunk - Bug #10860] [Closed] tool/mdoc2man.rb doesn't handle man/rake.1 correctly

Issue #10860 has been updated by Usaku NAKAMURA.

Status changed from Open to Closed

----------------------------------------
Bug #10860: tool/mdoc2man.rb doesn't handle man/rake.1 correctly
https://bugs.ruby-lang.org/issues/10860#change-52623

* Author: Jeremy Evans
* Status: Closed
* Priority: Normal
* Assignee: 
* ruby -v: ruby 2.2.0p0 (2014-12-25 revision 49005) [x86_64-openbsd]
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN, 2.2: UNKNOWN
----------------------------------------
Before r48658, rake.1 was in mdoc format, and tool/mdoc2man.rb handled it correctly.  In r48658, rake.1 was switched to man format, and tool/mdoc2man.rb doesn't handle it correctly, resulting in a broken manual page.  Either tool/rbinstall.rb should be modified not to run tool/mdoc2man.rb on rake.1, or tool/mdoc2man.rb should be improved to handle man format without modification.

Alternatively, r48658 could be reverted, putting rake.1 back in mdoc format, and then rake.1 could be updated to reflect the new options to rake.  However, I don't see that as a good option unless the upstream rake developers are open to changing rake.1 manual format from man to mdoc.

Note that this isn't a issue if --with-mantype=doc is passed to ./configure or if ./configure determines that mdoc format is supported.

Any change should probably be backported to 2.2, but not earlier versions, as rake.1 uses mdoc format in earlier versions.



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