bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [bug #24052] man page info.1 is nearly useless


From: Karl Berry
Subject: Re: [bug #24052] man page info.1 is nearly useless
Date: Thu, 14 Aug 2008 12:34:32 -0500

Hi Dan,

Thanks for the report.

    So I broke down and looked at the manual page...which told me
    nothing about how to actually use the program.  

It's generated from the --help message, as with many other GNU packages.
I don't want to maintain information in yet another place, the current
situation is already suboptimal.

    Giving a brief summary of the useful command keys would go a long way.  

When you first start up Info, it tells you "type h for help".  I think
that's what you're basically looking for.

I rather doubt you'll find it sufficient, but maybe it's better than
nothing: I changed the help message (and hence the man page) to mention
this, and give examples of reading the Info manuals (of which there are
two -- long story, sigh).  Thus, it now looks like this:

  ...
  items relative to the initial node visited.

  For a summary of key bindings, type h within Info.

  Examples:
    info                       show top-level dir menu
    info info                  show the general manual for Info readers
    info info-stnd             show the manual specific to this Info program
    info emacs                 start at emacs node from top-level dir
    ...

(I'll make another pretest in a bit so the translators will have a chance.)

Best,
karl




reply via email to

[Prev in Thread] Current Thread [Next in Thread]