From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with archive (Exim 4.43) id 1JKXbT-0001Ht-HE for mharc-grub-devel@gnu.org; Thu, 31 Jan 2008 06:29:11 -0500 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JKXbP-0001BV-3B for grub-devel@gnu.org; Thu, 31 Jan 2008 06:29:07 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JKXbE-0000w3-T9 for grub-devel@gnu.org; Thu, 31 Jan 2008 06:28:58 -0500 Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JKXbE-0000va-FA for grub-devel@gnu.org; Thu, 31 Jan 2008 06:28:56 -0500 Received: from ns39764.ovh.net ([91.121.25.85] helo=nexedi.com) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JKXbD-0003WM-I4 for grub-devel@gnu.org; Thu, 31 Jan 2008 06:28:55 -0500 Received: from [10.8.0.46] (unknown [10.8.0.46]) by nexedi.com (Postfix) with ESMTP id E87613EB27 for ; Thu, 31 Jan 2008 12:35:28 +0100 (CET) From: "Yoshinori K. Okuji" Organization: enbug.org To: The development of GRUB 2 Date: Thu, 31 Jan 2008 12:28:50 +0100 User-Agent: KMail/1.9.4 References: <1201769188.10303.21.camel@solid.paris.klabs.be> In-Reply-To: <1201769188.10303.21.camel@solid.paris.klabs.be> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200801311228.51594.okuji@enbug.org> X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 3) Subject: Re: Docs X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: The development of GRUB 2 List-Id: The development of GRUB 2 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 31 Jan 2008 11:29:10 -0000 On Thursday 31 January 2008 09:46, Franklin PIAT wrote: > After some thoughts, I'll release the documentation[1] I wrote, with > copyright assignments to FSF, Dual licensed under GPL+GFDL. Thank you very much. > I wish I could have left it on a Wiki, then do docbook/xml export, then > converting it to info+manpages... > > * But I guess it won't be possible if we need copyright assignments > from contributors (although I think it might be possible to make some > group based ACLs in Moinmoin wiki). I (or maybe Marco as well?) can set up an ACL, if you wish. > * What do you think about maintaining the documentation in docbook > then converting it to texinfo ? Would it fit FSF Coding style ? Docbook is acceptable. In fact, it is used in some projects in GNU (such as GNOME, IIRC). But I think the problem is mostly the reusability. I believe that we can reuse several parts of the GRUB manual (for GRUB Legacy) as they are, and this is in texinfo format. > I've had a deeper look at Texinfo : The specification are larger > that html (i don't have the time to learn it)... And I haven't > fount authoring tool, etc... It looks big, only because the texinfo manual contains a lot of examples. In reality, much smaller than the Docbook spec. And, you know, HTML does not specify printing. Anyway, the best way of using texinfo is to start from examples. In our case, you can copy the manual from GRUB Legacy, and tweak it. FYI, Emacs supports texinfo very well. Okuji