Re: More missing options for guile/doc/guile.1

[Andy Wingo <wingo@pobox.com>]

On Thu 27 Jan 2011 20:25, Mark Harig <idirectscm@aim.com> writes:

> Here are some other language interpreters that have manual pages:
>
>    awk, bash, bc, clisp, dc, emacs, make
>
> "emacs" and "make" follow the terse approach, while the others do not.
> These can be examined to help decide whether you would prefer for those
> programs to have a terse manual page or not.

For what it's worth, I think a more complete man page is better for
users.  However I personally don't want to maintain a man page.  If you
are interested in working on the man page though, by all means, let's
have a nice one!

> Speaking of on-line manuals, I would like to point to Org-mode's manual,
> which has melded info and HTML together so that info keyboard
> commands can be used to move through the manual (that is, some
> commands, such as 'n', 'p', 'u', 't', '1', '2', but not all), while
> still allowing
> mouse users to click on links.
>
> http://orgmode.org/guide/index.html
>
> This is something I would like to see all GNU online manuals that
> are derived from texinfo files aspire to.  Can a guile version of
> http://orgmode.org/org-keys.js be written?

Neat!  Yes is the answer; but it would be best if this made its way into
makeinfo itself.  I hear makeinfo is about to undergo a new release --
see http://www.gnu.org/bulletins/gnustatus-2011-01.html#Texinfo -- with
a new more active maintenance, so perhaps now is the hour for great GNU
manuals, across the board!

Cheers,

Andy
-- 
http://wingolog.org/