[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: grub.info
From: |
Vladimir 'φ-coder/phcoder' Serbinenko |
Subject: |
Re: grub.info |
Date: |
Thu, 03 Dec 2009 12:37:40 +0100 |
User-agent: |
Mozilla-Thunderbird 2.0.0.22 (X11/20091109) |
> 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.
Looks good but few comments follow.
>
> 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.=
I'll gladly answer you. We can use IRC for faster information exchange.
>
> * Booting
> * General boot methods
> * Loading an operating system directly
> * Chain Loading
> * OS-specific notes
> * SCO UnixWare <-- Do we really need this
You can remove it alright if someone still needs it he's free to document=
it
> * DOS/Windows
>
> * Commuication with GRUB
> * File access
> * PS/2 Devices
> * USB I/O Devices
> * Serial I/O Devices
>
> * GRUB Modules
> <Document Each Module>
>
It looks like a big overlap with other chapters (nearly everything is a
module). I don't see a need of this section.
> * 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
I think the better name would be something like "OS loaders". Perhaps
merge with "Boot methods"
> * chainloader
> * freebsd_loadenv
> * freebsd_module
> * freebsd_module_elf
> * initrd
> * initrd16
> * linux
> * linux16
> * multiboot
> * netbsd
> * openbsd
It's better to order them by OS rather than alphabetically. E.g. "Linux
booting" would document both linux and initrd and mention legacy
linux16/initrd16 booting method.
>
> * 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
This aren't EFI commands but commands to manipulate efiemu
>
> * Xnu_devdree
"Mac OS X/Darwin booting" would be a better name. This should be a
subsection of booting methods.
> * 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
Removed in GRUB2
> * find
Replaced by 'search'
> * terminal
REplaced by terminal_input/terminal_output
> * uppermem
Removed in GRUB2. Replaced by badram
>
> * Copying This Manual
> * GNU Free Documentation License
>
> * Index
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
>
>
> _______________________________________________
> Grub-devel mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/grub-devel
>
--=20
Regards
Vladimir '=CF=86-coder/phcoder' Serbinenko
signature.asc
Description: OpenPGP digital signature
- Customization of GRUB2, Bruce Dubbs, 2009/12/01
- Re: Customization of GRUB2, Vladimir 'φ-coder/phcoder' Serbinenko, 2009/12/01
- Re: Customization of GRUB2, Vladimir 'φ-coder/phcoder' Serbinenko, 2009/12/01
- Re: Customization of GRUB2, Bruce Dubbs, 2009/12/01
- grub.info, Bruce Dubbs, 2009/12/02
- Re: grub.info, Seth Goldberg, 2009/12/02
- Re: grub.info,
Vladimir 'φ-coder/phcoder' Serbinenko <=
- Re: grub.info, Bruce O. Benson, 2009/12/28
- Re: grub.info, Bruce Dubbs, 2009/12/29
- Re: grub.info, Bruce O. Benson, 2009/12/29
- Re: grub.info, Bruce Dubbs, 2009/12/29
- Re: grub.info, Bruce O. Benson, 2009/12/29
- Re: grub.info, Felix Zielcke, 2009/12/30
- Re: grub.info, Vladimir 'φ-coder/phcoder' Serbinenko, 2009/12/31
- Re: grub.info, Vladimir 'φ-coder/phcoder' Serbinenko, 2009/12/30
- Re: grub.info, Bruce O. Benson, 2009/12/30
- Re: grub.info, Bruce Dubbs, 2009/12/30