bug-coreutils
[Top][All Lists]
Advanced

[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:1.8.0.10) Gecko/20070221 Thunderbird/1.5.0.10 Mnenhy/0.7.5.666

-----BEGIN PGP SIGNED MESSAGE-----
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
-----BEGIN PGP SIGNATURE-----
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

iD8DBQFGIpJw84KuGfSFAYARAm+rAJ4zTxvM/zL+KhIetwu0rR8bTdWCGwCgrdE8
Qn3aDhmRMD2VlMLLFNGBah8=
=d6aX
-----END PGP SIGNATURE-----




reply via email to

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