[Top][All Lists]

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

Re: ls 6.7 man page bugs (unterminated bold macros)

From: Eric Blake
Subject: Re: ls 6.7 man page bugs (unterminated bold macros)
Date: Sun, 15 Apr 2007 15:00:33 -0600
User-agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv: Gecko/20070221 Thunderbird/ Mnenhy/

Hash: SHA1

According to amores perros on 4/15/2007 1:04 PM:
> ls 6.7
> In the man page, the options are in bold, and the explanations are not,
> except

Thanks for the report.  However, the man page is generated using the
'help2man' tool from the 'ls --help' output, so you may want to
investigate whether these are bugs in that tool, rather than in ls.

> --------------
> I was figuring out how to write a man page,
> and looked at the ls one for reference, and
> noticed these.

Manually writing man pages tends to be a pretty harsh way to do things.
Man pages are relatively obsolete, and not required by the GNU Coding
Standards.  These days, it is easier to generate a man page using an
automated tool that parses input from another format.

- --
Don't work too hard, make some time for fun as well!

Eric Blake             address@hidden
Version: GnuPG v1.4.5 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org


reply via email to

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