grub-devel
[Top][All Lists]
Advanced

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

Re: grub manpages...


From: Marco Gerards
Subject: Re: grub manpages...
Date: Thu, 24 Jan 2008 13:01:59 +0100
User-agent: Gnus/5.110006 (No Gnus v0.6) Emacs/21.4 (gnu/linux)

"Franklin PIAT" <address@hidden> writes:

> On Thu, January 24, 2008 10:05, Yoshinori K. Okuji wrote:
>> 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 ?
>> 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.
> I personnaly don't like info (actually, I never fount a proper info
> browser). However I'm willing to do what you prefer.

Please have a look at the GRUB Legacy manual.  It's quite big and the
approach cannot directly be compared to a manpage.

>> So having a manual in Info format is a must.
> Fine.
>
>> 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.
> I guess we can do it again.
>
>> So, I accept manually written manpages, only if someone is going to
>> maintain them seriously for a long, long time (years).
> I'm not planning to maintain grub infopages for long time. I'll try
> to keep up-to-date until it gets stable (hopefully not much more than a
> year ;).

Okuji meant manpages.  We are willing to maintain an info manual.
Although your willingness to maintain it for a while will certainly
help.

--
Marco





reply via email to

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