From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with archive (Exim 4.43) id 1Q5BEb-0007NY-1b for mharc-grub-devel@gnu.org; Thu, 31 Mar 2011 02:19:57 -0400 Received: from [140.186.70.92] (port=38388 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q5BEX-0007MB-7A for grub-devel@gnu.org; Thu, 31 Mar 2011 02:19:54 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q5BEV-0001b0-VD for grub-devel@gnu.org; Thu, 31 Mar 2011 02:19:53 -0400 Received: from mail-yi0-f41.google.com ([209.85.218.41]:49191) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q5BEV-0001at-Rn for grub-devel@gnu.org; Thu, 31 Mar 2011 02:19:51 -0400 Received: by yib18 with SMTP id 18so1012024yib.0 for ; Wed, 30 Mar 2011 23:19:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:message-id:date:from:user-agent:mime-version:to :subject:references:in-reply-to:content-type :content-transfer-encoding; bh=DPaTHmHukY51+qR8QOW5j1OdGvojrZVHAtOhrcMGZws=; b=ipcqBxsmDAX1rpCpbJDBfwR/8wHuBaQDSPVW85+026XfweWHjhb5aT1qf2WxLPpLG+ tpUh4sokZ/8U5MeHwf1ZlvlKl/A76Z/2SWyoAgVZWBbl5YraAm7scMv1Jlqwi5AIeA2h XCGFtIYmR0XksenKaM7ptjdQYpHTu9Dfu7u5Y= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; b=wJ/VmvmN8gwOLydcw0ChIGYf9kRpKNUe5GSEhmPX0yyG/UNjJ7fsLnicAXklfCVqSe 4nGjzY1KkciddIG3xiLko5+XC7vjyaUw9Gm2fQq0Dfbzw+jEO7X4xJcfvs2d8Klh0mEN 2inzAZzB8sjvsglTNmEtbtsBQoaiRGihR0OX8= Received: by 10.150.169.2 with SMTP id r2mr2670592ybe.425.1301552390843; Wed, 30 Mar 2011 23:19:50 -0700 (PDT) Received: from [192.168.0.75] (cpe-72-181-111-242.satx.res.rr.com [72.181.111.242]) by mx.google.com with ESMTPS id l30sm447087yhn.96.2011.03.30.23.19.49 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 30 Mar 2011 23:19:50 -0700 (PDT) Message-ID: <4D941D05.7040107@gmail.com> Date: Thu, 31 Mar 2011 01:19:49 -0500 From: Bruce Dubbs User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.1.16) Gecko/20080722 SeaMonkey/1.1.11 MIME-Version: 1.0 To: The development of GNU GRUB References: <239CEBDEE83EB949A48B6DB812AA19F602C47A30@ex2.zuv.uni-muenchen.de> <2913A42B-33C4-4FE1-8826-52626032F566@colorremedies.com> In-Reply-To: <2913A42B-33C4-4FE1-8826-52626032F566@colorremedies.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 209.85.218.41 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: Thu, 31 Mar 2011 06:19:54 -0000 Chris Murphy wrote: > On Mar 29, 2011, at 9:19 AM, Patrick Strasser wrote: >> 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... ;-) > >> It's the developers task and skill to document features. > > I agree, but from this outsider's perspective, it's abundantly clear > the developers have totally abdicated on this. That's a bit harsh. The devs are a very small group and the technical details are vast. There is some effort going on to do the documentation, but it takes time. It is only a .98 release right now which means it is under development. To describe what GRUB2 does will take a moderate size book. The entire project is a mini-operating system. I personally don't really think a lot of the bells and whistles (e.g. scripting, graphics) are needed for something that most users will look at for 5 seconds as they boot (if at all). My own grub.cfg looks like: ### grub.cfg set default=0 set timeout=5 insmod ext2 set root=(hd0,1) menuentry "LFS SVN 20110204, Linux 2.6.37" { linux /linux-2.6.37 root=/dev/sda14 ro } menuentry "LFS SVN 20100627, Linux 2.6.34-label" { linux /linux-2.6.34 root=LABEL=lfs-svn ro } and it works fine. On the other hand, I don't do Windows, BSD, MAC, serial IO for boot, nfs boot, tftp boot, a boot sector on raid, EFI, initrd, grub-mkconfig, or a myriad of other things that GRUB supports. -- Bruce