[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [screen-devel] Screen documentation
From: |
Micah Cowan |
Subject: |
Re: [screen-devel] Screen documentation |
Date: |
Fri, 11 Jul 2008 11:55:46 -0700 |
User-agent: |
Thunderbird 2.0.0.14 (X11/20080421) |
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Juergen Weigert wrote:
> I will advocate to have both man and techinfo, for its a matter of taste.
> We should not force man-lovers into becoming grumpy-texinfo-users or
> vice versa.
> And I mean having them both with equal contents, so that it is a
> freedom of choice;
> not one pointing to the other, so that you have to know both.
>
> Hyperlinks have their use, though, I wish nroff would allow them.
When I'm writing documentation for my own projects, I usually do prefer
man, at least for reference documentation; or else I do everything in
DocBook (and perhaps generate a manpage from that).
When I'm doing GNU projects... I would probably do just pure Texinfo,
and let man rot, except that I know that some GNU/Linux distributions
(notably Debian) require that all packages have man pages, which means
if I don't write 'em, the package maintainer will have to. :) So I end
up doing both.
- --
Micah J. Cowan
Programmer, musician, typesetting enthusiast, gamer,
and GNU Wget Project Maintainer.
http://micah.cowan.name/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
iD8DBQFId6yy7M8hyUobTrERAk4tAJ0bnfzc5LZe59aXV/GEKdmFIBu3JwCfWrl3
Yne+SzNvK0JC0ncxT4p/7yI=
=baNi
-----END PGP SIGNATURE-----