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."
 };
 
 

Reply via email to