[Top][All Lists]

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

Re: Man-writing volunteers?

From: Juergen Weigert
Subject: Re: Man-writing volunteers?
Date: Tue, 12 Aug 2008 20:03:43 +0200
User-agent: Mutt/1.5.7i

Thomas, thanks for stepping forward!
Personally, I also prefer manpages. Probably mostly because
I know how to search and jump with less.

On Aug 12, 08 17:45:08 +0100, Thomas Adam wrote:
> I will state at this point, categorically, that although being true to
> GNU's roots is nice, I am dead against texinfo pages -- *no* one
> actually reads them; heck, the existing info viewer is an abomination,
> pinfo is "OK" but is not ubiquitous so it's out of the running for
> most people.  No... I seriously suggest we just make the manpage a
> fore-runner -- at least an "official" representation of our
> documentation.

Having only a texinfo page, is not that bad.
- one could always do 'info gdb | less' as a workaround.
- It just looks great, when printed on paper.

> > To my mind, unifying on a single source format would be the best
> > long-term approach, rather than having two manuals maintained. So far,
> > the approach that makes the most sense to me is to use the Texinfo as
> > the source document, generating the manpage with (see Wget's
> > Texinfo documentation for an understanding of this; note that, even with
> >, however, Wget's man page is still very much inferior to
> > their Texinfo counterparts: only a small portion is translated into the
> > man page). However, for Screen this would require to be
> > modified to allow arbitrary sections to be transmitted (it only allows
> > the standard ones, currently).
> Or use asciidoc or txt2tags, etc.

I like that plan!


 o \  Juergen Weigert      unix-software __/ _=======.=======_     
<V> | address@hidden         creator    __/        _---|____________\/    
 \  |            0179/2069677      __/          (____/            /\
(/) | ____________________________/              _/ \_ vim:set sw=2 wm=8

reply via email to

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