Bug #5598: man pages are in mdoc format

• Status: Closed
• Assignee: yugui (Yuki Sonoda)
• Target version: 1.9.2
• ruby -v: ruby 1.9.2p290 (2011-07-09 revision 32553) [sparc-solaris2.10]

[ro (Rainer Orth)]

Unfortunately, the ruby man pages are in mdoc format (as detected by grog).
The Solaris man/nroff commands cannot deal with that format, rendering the man
pages effectively useless.

Please provide them using only man macros instead so they are universally
useful.

[nobu (Nobuyoshi Nakada)]

• Category set to doc
• Status changed from Open to Feedback

Doesn't `make install MANTYPE=man' work?

[kernigh (George Koehler)]

• File p-mantype.diff p-mantype.diff added

Ruby should use its tool/mdoc2man.rb to convert mdoc format to man format. This is broken because some targets in Makefile forgot to pass --mantype="$(MANTYPE)" to INSTRUBY (tools/rbinstall.rb). Now make install' and make install-all' ignore MANTYPE and always install mdoc format.

I attached a quick patch. It moves --mantype="$(MANTYPE)" into INSTRUBY_ARGS, so every install target always passes MANTYPE.

[yugui (Yuki Sonoda)]

• Status changed from Feedback to Assigned
• Assignee set to yugui (Yuki Sonoda)
• Target version set to 1.9.2

=begin
HI George,

Thank you for your patch. I'll take a look at this issue.
=end

[yugui (Yuki Sonoda)]

• Status changed from Assigned to Closed
• % Done changed from 0 to 100

This issue was solved with changeset r33886.
Rainer, thank you for reporting this issue.
Your contribution to Ruby is greatly appreciated.
May Ruby be with you.

---

• common.mk (INSTRUBY_ARGS): added --mantype to apply mdoc2man.rb
  to man pages. Fixes #5598.
  (do-install-nodoc, do-install-local, do-install-man,
  dont-install-nodoc, dont-install-local, dont-install-man):
  No longer needs --mantype.

  Reported by Rainer Orth ,
  patch by George Koehler .