[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: More missing options for guile/doc/guile.1
From: |
Andy Wingo |
Subject: |
Re: More missing options for guile/doc/guile.1 |
Date: |
Thu, 27 Jan 2011 23:35:01 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) |
On Thu 27 Jan 2011 20:25, Mark Harig <address@hidden> 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/