Re: grub manpages...

[Yoshinori K. Okuji]

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 :
> > http://wiki.debian.org/Grub/grub-install.manpage
> > http://wiki.debian.org/Grub/grub-mkimage.manpage
> > http://wiki.debian.org/Grub/grub-mkrescue.manpage
> > http://wiki.debian.org/Grub/grub-setup.manpage
> >
> > 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.

Okuji