[Top][All Lists]
[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