Project

General

Profile

Actions

Bug #5598

closed

man pages are in mdoc format

Added by ro (Rainer Orth) almost 13 years ago. Updated almost 13 years ago.

Status:
Closed
Target version:
ruby -v:
ruby 1.9.2p290 (2011-07-09 revision 32553) [sparc-solaris2.10]
Backport:
[ruby-core:40844]

Description

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.


Files

p-mantype.diff (2.74 KB) p-mantype.diff patch common.mk to always pass --mantype="$(MANTYPE)" kernigh (George Koehler), 11/24/2011 07:29 AM

Related issues 1 (0 open1 closed)

Related to Backport193 - Backport #5682: Backport r33886 (convert mdoc to man properly)Closed11/29/2011Actions

Updated by nobu (Nobuyoshi Nakada) almost 13 years ago

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

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

Updated by kernigh (George Koehler) almost 13 years ago

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.

Updated by yugui (Yuki Sonoda) almost 13 years ago

  • 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

Actions #4

Updated by yugui (Yuki Sonoda) almost 13 years ago

  • 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 .

Actions

Also available in: Atom PDF

Like0
Like0Like0Like0Like0