From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with archive (Exim 4.43) id 1NG0W4-0005OE-KO for mharc-grub-devel@gnu.org; Wed, 02 Dec 2009 20:29:56 -0500 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NG0W2-0005Ks-81 for grub-devel@gnu.org; Wed, 02 Dec 2009 20:29:54 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NG0Vx-0005CA-Iw for grub-devel@gnu.org; Wed, 02 Dec 2009 20:29:53 -0500 Received: from [199.232.76.173] (port=39856 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NG0Vw-0005BY-TR for grub-devel@gnu.org; Wed, 02 Dec 2009 20:29:48 -0500 Received: from mail-gx0-f224.google.com ([209.85.217.224]:57095) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NG0Vw-0005pz-Fk for grub-devel@gnu.org; Wed, 02 Dec 2009 20:29:48 -0500 Received: by gxk24 with SMTP id 24so20458gxk.6 for ; Wed, 02 Dec 2009 17:29:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=YBXePRQJ2E7ieuN3PoML0s6E+00liwhhh5w0EFKir2o=; b=QqM76WitX/DopHOSLcqIm66jqGdLIsF+MIt8PhCFkf2Bo3RP0Sg+rtaZqj87kHGNh2 TDjbJZeuhPvJbVylnSZTy+2bRmS+7MXslLYkqIuZnTHL3r+tMXevY+wi42/9D2x1bAcz wqxSjG+ePA2rgR0SK8PxIMAqePjpa4sBoXqdo= 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=LLRqol6/poWoEvcHzvqsf4aHev07nMPZj5ABqojwCzxVxtiegMN7Qp7wypBOi1A5iK s3djtsbt7MmR1L99CgtDYqe9dExTBFqpu2KkOuRcMiVcYCqw77Z3PTztna43i9vjClMo 7yNX1i1q96xNhD0VGrOV4h93NDShI3BpHZsTI= Received: by 10.101.205.1 with SMTP id h1mr1152661anq.13.1259803786520; Wed, 02 Dec 2009 17:29:46 -0800 (PST) Received: from ?192.168.0.75? (cpe-66-69-97-231.satx.res.rr.com [66.69.97.231]) by mx.google.com with ESMTPS id 15sm834530yxh.58.2009.12.02.17.29.45 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 02 Dec 2009 17:29:46 -0800 (PST) Message-ID: <4B171489.4050009@gmail.com> Date: Wed, 02 Dec 2009 19:29:45 -0600 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: <4B157A71.5060402@gmail.com> <4B157B51.2060402@gmail.com> <4B1582CD.2020906@gmail.com> <4B159518.8060709@gmail.com> <4B15A877.1080604@gmail.com> In-Reply-To: <4B15A877.1080604@gmail.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Subject: grub.info 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, 03 Dec 2009 01:29:54 -0000 Bruce Dubbs wrote: > Vladimir 'φ-coder/phcoder' Serbinenko wrote: >>>> Could you help us with documenting grub better? Patches against texinfo >>>> manual are welcome > >>> I may be able to do that, however, I need to learn it myself. I took a look at grub.texi. Although I haven't written any texi files before, I was able to figure out the format and run makeinfo without any errors. That means that I only have to worry about small things like content. :) I have examined the hierarchy of the manual and it currently has the structure below. I also did some research and propose a different layout, also shown below. What I propose to do is to update the text file to the new layout, filling in what I can and adding placeholders for other areas. Then, I will ask for contributions to fill in the holes. I'll gladly do the formatting if I can get the content. I freely admit that I don't yet have a good handle on many of the areas that need documentation and that I'll need to ask many questions. If this is acceptable, please provide feedback to my proposed layout. I have no problem with adding, deleting, renaming, or moving any of the sections. -- Bruce ----------------- Current Layout: * Introduction:: * Overview:: * History:: * Features:: * Role of a boot loader:: * Naming convention:: * Installation:: * Installing GRUB using grub-install:: * Making a GRUB bootable CD-ROM:: * Booting:: * General boot methods:: * Loading an operating system directly:: * chain-loading:: * OS-specific notes:: * Configuration:: * Network:: * Serial terminal:: * Preset Menu:: * Images:: * Filesystem:: * Device syntax:: * File name syntax:: * Block list syntax:: * Interface:: * Command-line interface:: * Menu interface:: * Menu entry editor:: * Commands:: * Menu-specific commands:: * menuentry * General commands:: * serial:: * terminfo:: * Command-line and menu entry commands:: * acpi:: * blocklist:: * boot:: * cat:: * chainloader:: * cmp:: * configfile:: * crc:: * date:: * echo:: * export:: * halt:: * help:: * insmod:: * keystatus:: * ls:: * reboot:: * set:: * unset:: * Troubleshooting:: * Invoking the grub shell:: * Invoking grub-install:: * Invoking grub-terminfo <-- Does not appear to exist outside of cmdline * Obtaining and Building GRUB:: * Reporting bugs:: * Future:: * Internals:: * Copying This Manual:: * GNU Free Documentation License * Index:: -------------- Proposed layout: GNU GRUB manual * Introduction * Overview * History * Features * Role of a boot loader * Syntax * grub.cfg syntax * Naming conventions * Device syntax * File name syntax * Block list syntax * Installation * Installing GRUB using grub-install * Installing GRUB manually * Making a GRUB bootable CD-ROM * Installing GRUB for network booting * Booting * General boot methods * Loading an operating system directly * Chain Loading * OS-specific notes * SCO UnixWare <-- Do we really need this * DOS/Windows * Commuication with GRUB * File access * PS/2 Devices * USB I/O Devices * Serial I/O Devices * GRUB Modules * User Interface * Menu interface * Command-line interface * Menu entry editor * Menu Customization * VT100 I/O * Security * Images * Command Reference * grub-dumpbios * grub-editenv * grub-emu * grub-fstest * grub-mkconfig * grub-mkdevicemap * grub-mkelfimage * grub-mkfont * grub-mkimage * grub-mkrescue * grub-probe * grub-setup * Configuration Reference * General Commands * blocklist * cmp * configfile * crc * date * drivemap * dump * false * handler * hello * help * hexdump * insmod * list_env * load_env * loopback * ls * lsfonts * lsmap * lsmod * module * parser.lua * parser.rescue * parser.sh * play * read_byte * read_dword * reader.normal * reader.rescue * rmmod * root * save_env * search * set * sleep * source * terminfo * test * true * vbeinfo * write_byte * write_dword * write_word * Menu Control Commands * background_image * gptsync * keystatus * loadfont * password * terminal_input * terminal_input.at_keyboard * terminal_input.console * terminal_input.serial * terminal_input.usb_keyboard * terminal_output * terminal_output.console * terminal_output.gfxterm * terminal_output.serial * terminal_output.vga * terminal_output.vga_text * Menu Item Commands * chainloader * freebsd_loadenv * freebsd_module * freebsd_module_elf * initrd * initrd16 * linux * linux16 * multiboot * netbsd * openbsd * Computer Control Commands * acpi * badram * boot * cpuid * halt * hdparm * lspci * parttool * probe * pxe * reboot * serial * usb * vbetest * videotest * EFI Commands * efiemu_loadcore * efiemu_pnvram * efiemu_prepare * efiemu_unload * Xnu_devdree * xnu_kernel * xnu_kext * xnu_kextdir * xnu_mkext * xnu_ramdisk * xnu_resume * xnu_splash * xnu_uuid * Troubleshooting * Obtaining and Building GRUB * Reporting bugs * Other * testload * Device map * root * find * terminal * uppermem * Copying This Manual * GNU Free Documentation License * Index ==================