[Top][All Lists]

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

Re: grub manpages...

From: Yoshinori K. Okuji
Subject: Re: grub manpages...
Date: Thu, 24 Jan 2008 10:05:05 +0100
User-agent: KMail/1.9.4

On Wednesday 23 January 2008 23:27, Robert Millan wrote:
> On Wed, Jan 23, 2008 at 10:50:50PM +0100, Franklin PIAT wrote:
> > Hello,
> >
> > I've started more manpages :
> >
> >
> >
> >
> >
> > What would be your preferred file format ?
> I think info manual format is preferred, but manpages are fine AFAIK. 
> You'd have to see what Marco or Okuji will say.

Info is mandantory to be fully compatible with the GNU Coding Standards. And, 
Info is very convenient to write detailed information, such as a tutorial. So 
having a manual in Info format is a must.

Manpages are convenient for quick references. Of course, they are good to 
have. However, maintaining two separate manuals is a pain. That was why GRUB 
Legacy simply used automatically generated manpages.

So, I accept manually written manpages, only if someone is going to maintain 
them seriously for a long, long time (years). Otherwise, I prefer to generate 
manpages mechanically, even though they are not as good as hand-made ones.


reply via email to

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