From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with archive (Exim 4.43) id 1Q4bBN-0004Ah-HX for mharc-grub-devel@gnu.org; Tue, 29 Mar 2011 11:50:13 -0400 Received: from [140.186.70.92] (port=41314 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q4bBL-0004A3-CM for grub-devel@gnu.org; Tue, 29 Mar 2011 11:50:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q4bBJ-0000IS-OE for grub-devel@gnu.org; Tue, 29 Mar 2011 11:50:11 -0400 Received: from lo.gmane.org ([80.91.229.12]:55346) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q4bBJ-0000Hv-Em for grub-devel@gnu.org; Tue, 29 Mar 2011 11:50:09 -0400 Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1Q4bBD-0004dJ-Te for grub-devel@gnu.org; Tue, 29 Mar 2011 17:50:03 +0200 Received: from pc216045.con.tu-graz.ac.at ([129.27.216.45]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 29 Mar 2011 17:50:03 +0200 Received: from patrick.strasser by pc216045.con.tu-graz.ac.at with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 29 Mar 2011 17:50:03 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: grub-devel@gnu.org From: Patrick Strasser Date: Tue, 29 Mar 2011 17:19:09 +0200 Message-ID: References: <239CEBDEE83EB949A48B6DB812AA19F602C47A30@ex2.zuv.uni-muenchen.de> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: pc216045.con.tu-graz.ac.at User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; de; rv:1.9.2.15) Gecko/20110303 Lightning/1.0b3pre Mnenhy/0.8.3 Thunderbird/3.1.9 In-Reply-To: <239CEBDEE83EB949A48B6DB812AA19F602C47A30@ex2.zuv.uni-muenchen.de> X-Enigmail-Version: 1.1.1 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 80.91.229.12 Cc: help-grub@gnu.org Subject: Re: Full documentation for GRUB2 X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: The development of GNU GRUB List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 29 Mar 2011 15:50:12 -0000 schrieb Treutwein Bernhard am 2011-03-24 16:06: > Hi Bill & Robert, > > [...] >>> Is there some complete official documentation of GRUB2, or is GRUB2 full >>> documentation only in source code?;-) >> >> I think the Grub2 developers would welcome volunteers to help write >> documentation. > > this is kind of a hen & egg problem. > > I have no idea how I can find out how to use modules where I > have to guess how to use them. There was a nice remark on > by phcoder on the request list that there are usb mass storage > and uhci & ehci modules, which I tried and I was able to confirm > that insmod'ing uhci.mod and usbms.mod on a system, which is not > able to boot via bios from usb, enabled this system to boot > from usb by chainloading (usb0)+1. But it is very time consuming > and frustrating to experiment with different modules just for > documentation. I had a simmilar experience regarding the loopback system - which is by itself really great. The manual gives a hint of the command, but no description and no example. I got some working examples from Ubuntu [ubuntu] and from pendrivelinux.com [pendrive:0][pendrive:1], but no documentation. >From my experience it's not working to get some newbies or helpers to write docs. It's the developers task and skill to document features. Others can then edit this information into nice manuals and spice it with examples (which they can figure out easily with the raw docs). Moreover googling is no alternative to proper documentation. I'd like to contribute examples that I found to the grub docs, but the manual gives no hint how to do so... ;-) Patrick [ubuntu] https://help.ubuntu.com/community/Grub2 [pendrive:0]http://www.pendrivelinux.com/boot-multiple-iso-from-usb-via-grub2-using-linux/ [pendrive:1] http://pendrivelinux.com/downloads/multibootlinux/grub.cfg Engineers motto: cheap, good, fast: choose any two Patrick Strasser Student of Telemati_cs_, Techn. University Graz, Austria