Hello!
The new help messages are sometimes hard to understand.
I have modified most of them.
Unnecessary and ambigous passages like
"try loading a kernel with your code"
have been removed. I don't write kernels yet :-)
Also many errors have been fixed.
It would be nice if a native Englishman checked the messages after me.
The help messages for "root", "rootnoverify" and "testload" are too
hard for me :-(
I have no idea what "fix up automatic determination" means.
Also the purpose of HDBIAS remains unclear to me.
Is it something like "set root_disk_unit=" in FreeBSD?
Pavel Roskin
--- stage2/builtins.c Mon Sep 6 19:17:52 1999
+++ stage2/builtins.c Thu Sep 9 23:20:14 1999
@@ -191,9 +191,9 @@
" line in the menu, and the color HIGHLIGHT is used to highlight the"
" line where the cursor points to. If you omit HIGHLIGHT, then the"
" inverted color of NORMAL is used for the highlighted line. You"
- " must specify an integer for a color value, and the 0-3 bits"
- " represents the foreground color, the 4-6 bits represents the"
- " background color, and the 7 bit represents that the foreground"
+ " must specify an integer for a color value, where the bits 0-3"
+ " represents the foreground color, the bits 4-6 represents the"
+ " background color, and the bit 7 indicates that the foreground"
" blinks."
};
@@ -230,7 +230,7 @@
configfile_func,
BUILTIN_CMDLINE,
"configfile FILE",
- "Load the file FILE as the configuration file."
+ "Load FILE as the configuration file."
};
@@ -358,8 +358,7 @@
" errors, instead of waiting for the user to do anything, it"
" immediately starts over using the NUM entry (same numbering as the"
" `default=' command). This obviously doesn't help if the machine"
- " was in the middle of the boot process (after leaving GRUB's code)"
- " and rebooted."
+ " was rebooted, e.g. by the kernel code."
#endif
};
@@ -573,7 +572,8 @@
hide_func,
BUILTIN_CMDLINE | BUILTIN_MENU,
"hide DRIVE",
- "Hide the drive DRIVE by adding 0x10 into the partition type."
+ "Hide the drive DRIVE by setting the \"hidden\" bit"
+ " in the partition type code."
};
@@ -777,9 +777,9 @@
if (! new_drive)
new_drive = current_drive;
else if (current_drive != dest_drive)
- grub_printf ("Warning: the option `d' is not found, but Stage 2 will"
- "be install into a\ndifferent drive from a drive into"
- " which is installed Stage 1.\n");
+ grub_printf ("Warning: the option `d' is not used, but the Stage 1"
+ " will be installed on a\ndifferent drive than the"
+ " drive where the Stage 2 resides.\n");
memmove ((char*) BOOTSEC_LOCATION, buffer, SECTOR_SIZE);
@@ -884,16 +884,15 @@
install_func,
BUILTIN_CMDLINE,
"install STAGE1 [d] DEVICE STAGE2 ADDR [p] [CONFIG_FILE]",
- "Install STAGE1 into DEVICE, and install a blocklist for loading STAGE2"
+ "Install STAGE1 on DEVICE, and install a blocklist for loading STAGE2"
" as a Stage 2. If the option `d' is present, the Stage 1 will always"
- " look for the actual disk STAGE2 is installed on, rather than using"
+ " look for the disk where STAGE2 was installed on, rather than use"
" the booting drive. The Stage 2 will be loaded at address ADDR, which"
" must be 0x8000 for a true Stage 2, and 0x2000 for a Stage 1.5. If"
- " the option `p' or CONFIG_FILE are present, then it reads the first"
- " block of Stage 2, modifies it with the values of the partition STAGE2"
- " was found on for `p' or places the string CONFIG_FILE into the area"
- " telling the Stage 2 where to look for a configuration file at boot"
- " time."
+ " the option `p' and/or CONFIG_FILE are present, then the first block"
+ " Stage 2 is patched with new values of the partition and/or filename"
+ " of the file to be used as a configuration file by the true Stage 2"
+ " and as the true Stage 2 by the Stage 1.5 at the boot time."
};
@@ -929,10 +928,9 @@
"kernel FILE [ARG ...]",
"Attempt to load the primary boot image (Multiboot a.out or ELF,"
" Linux zImage or bzImage, FreeBSD a.out, or NetBSD a.out) from"
- " FILE. This command ignores the rest of the contents of the line,"
- " except that the entire line starting with FILE is"
- " passed verbatim as the \"kernel command line\". The module state is"
- " reset, and so you must reload any modules."
+ " FILE. The rest of the line is passed verbatim as the"
+ " \"kernel command line\". Any modules must be reloaded after"
+ " using this command."
};
@@ -953,8 +951,8 @@
BUILTIN_CMDLINE,
"makeactive",
"Set the active partition on the root disk to GRUB's root partition"
- " (on a floppy this has no effect). This is limited to working with"
- " _primary_ PC partitions."
+ " This is limited to working with _primary_ PC partitions on a hard"
+ " disk."
};
@@ -999,10 +997,10 @@
BUILTIN_CMDLINE,
"module FILE [ARG ...]",
"Load a boot module FILE for a Multiboot format boot image (no"
- " interpretation of the file contents are made, so that user of this"
+ " interpretation of the file contents is made, so that user of this"
" command must know what the kernel in question works with). The"
- " rest of the line is passed as the \"module command line\" much like"
- " with the `kernel=' command."
+ " rest of the line is passed as the \"module command line\" like"
+ " the `kernel=' command."
};
@@ -1031,7 +1029,7 @@
modulenounzip_func,
BUILTIN_CMDLINE,
"modulenounzip FILE [ARG ...]",
- "Exactly like `module=', except that automatic decompression is"
+ "The same as `module=', except that automatic decompression is"
" disabled."
};
@@ -1109,7 +1107,7 @@
quit_func,
BUILTIN_CMDLINE,
"quit",
- "Exit from the grub shell."
+ "Exit from the GRUB shell."
};
@@ -1132,8 +1130,8 @@
read_func,
BUILTIN_CMDLINE,
"read ADDR",
- "Read a 32-bit unsigned value from memory at address ADDR and"
- " displays it in hex format."
+ "Read a 32-bit value from memory at the address ADDR and"
+ " display it in hex format."
};
@@ -1301,7 +1299,7 @@
" filepos=Y' reading has X and Y equal, then it is definitely"
" consistent, and very likely works correctly subject to a"
" consistent offset error. If this test succeeds, then a good next"
- " step is to try loading a kernel with your code."
+ " step is to try loading a kernel."
};
@@ -1370,7 +1368,8 @@
unhide_func,
BUILTIN_CMDLINE | BUILTIN_MENU,
"unhide DRIVE",
- "Unhide the drive DRIVE by subtracting 0x10 from the partition type."
+ "Unhide the drive DRIVE by unsetting the \"hidden\" bit"
+ " in the partition type code."
};
@@ -1391,10 +1390,8 @@
uppermem_func,
BUILTIN_CMDLINE,
"uppermem KBYTES",
- "Force GRUB to ignore what it found during the autoprobe of the"
- " memory available to the system, and to use KBYTES as the number of"
- " kilobytes of upper memory installed. Any address range maps of the"
- " system are discarded."
+ "Force GRUB to think that only KBYTES kilobytes of upper memory are"
+ " installed. Any address range maps of the system are discarded."
};