As requested by Okuji, I'm splitting my docs changes in several
tranches (well, that's good for me as well, as I can type a few
of them each day :). I'm skipping over the multiboot specs by now.
> @c BTW, how many people think that this tutorial is easy to read? I
> @c don't know. God knows? I don't think so. :p - okuji
This one fixes typos and similar easy things, only the clarification
that this is PC-only is a not-too-minor change. As requested, there's
a changelog entry as well.
Complete list of changes:
- make explicit that it's only for the PC
- typo (initiailze)
- error in "how to specify blocklists" (300->600 should be 300->599)
(if this was correct, the previous line was wrong)
- standard-format dotted-decimal (for IP addresses)
- removed two newlines in "fstest" table entry, as no other entry
in the page has newlines in similar places
- typo: BIOS indicate -> BIOS indicates
- base board memory -> system memory (twice)
- base board -> motherboard (a few)
- several changes to one paragraph (about I/O ranges)
- typo: FE00 -> FEC0
- typeo: int13, AG-0x41: 01h for 1.0 -> 10h for 1.0 **** I'm not sure ****
- I -> we (twice: there are two authors)
According to the mailer being used, you may or may not have problems
with inline patches. If there are problems, I can use (preferred)
inline uuencode or "I hate it" mime.
Index: docs/prog-ref.texi
===================================================================
RCS file: /cvs/grub/docs/prog-ref.texi,v
retrieving revision 1.7
diff -u -d -u -r1.7 prog-ref.texi
--- docs/prog-ref.texi 2000/01/11 11:59:47 1.7
+++ docs/prog-ref.texi 2000/09/04 21:36:42
@@ -450,7 +450,7 @@
pass the continuation value unchanged as input to the next iteration of
the E820h call in order to get the next Address Range Descriptor. A
return value of zero means that this is the last descriptor. Note that
-the BIOS indicate that the last valid descriptor has been returned by
+the BIOS indicates that the last valid descriptor has been returned by
either returning a zero as the continuation value, or by returning
carry.
@end multitable
@@ -522,8 +522,8 @@
@enumerate
@item
-The BIOS will return address ranges describing base board memory and ISA
-or PCI memory that is contiguous with that base board memory.
+The BIOS will return address ranges describing system memory and ISA
+or PCI memory that is contiguous with that system memory.
@item
The BIOS @emph{will not} return a range description for the memory
@@ -535,7 +535,7 @@
used by devices as reserved.
@item
-Address ranges defined for base board memory mapped I/O devices (for
+Address ranges defined for memory mapped I/O devices (for
example APICs) will be returned as reserved.
@item
@@ -544,10 +544,10 @@
address space (4 GB).
@item
-Standard PC address ranges will not be reported. Example video memory at
+Standard I/O address ranges will not be reported. Example video memory at
A0000 to BFFFF physical will not be described by this function. The
-range from E0000 to EFFFF is base board specific and will be reported as
-suits the bas board.
+range from E0000 to EFFFF is motherboard-specific and will be reported
+differently on different computers.
@item
All of lower memory is reported as normal memory. It is OS's
@@ -591,9 +591,9 @@
@item 0100 0000 @tab 120M @tab ARM @tab Base board @sc{ram} relocated
above a chipset memory hole.
-@item FE00 0000 @tab 4K @tab ARR @tab IO APIC memory mapped I/O at
+@item FEC0 0000 @tab 4K @tab ARR @tab IO APIC memory mapped I/O at
FEC00000. Note the range of addresses required for an APIC device may
-vary from base OEM to OEM.
+vary from one motherboard manufacturer to another
@item FEE0 0000 @tab 4K @tab ARR @tab Local APIC memory mapped I/O at
FEE00000.
@@ -787,7 +787,7 @@
when CHS addressing is used at the INT 13H interface.
First, all OS's that want to be co-resident with another OS (and that is
-all of the PC based OS's that I know of) @emph{must} use INT 13H to
+all of the PC based OS's that we know of) @emph{must} use INT 13H to
determine the capacity of a hard disk. And that capacity information
@emph{must} be determined in L-CHS mode. Why is this? Because:
@@ -1047,7 +1047,7 @@
@multitable @columnfractions 0.15 0.85
@item @code{CF} @tab Set on error.
-@item @code{AH} @tab Major version of extensions (01h for 1.x, 20h for
+@item @code{AH} @tab Major version of extensions (10h for 1.x, 20h for
2.0 / EDD-1.0, 21h for 2.1 / EDD-1.1 and 30h for EDD-3.0) if successful,
otherwise 01h (the error code of @dfn{invalid function}).
@@ -1332,7 +1332,7 @@
the first 466 bytes). For more information, see @ref{MBR}.
Second, extended partitions are @emph{nested} inside one another and
-extended partition table records form a @dfn{linked list}. I will
+extended partition table records form a @dfn{linked list}. We will
attempt to show this in a diagram at @ref{Partition entry format}.
Each partition table entry is 16 bytes and contains things like the
Index: docs/tutorial.texi
===================================================================
RCS file: /cvs/grub/docs/tutorial.texi,v
retrieving revision 1.19
diff -u -d -u -r1.19 tutorial.texi
--- docs/tutorial.texi 2000/08/10 22:48:14 1.19
+++ docs/tutorial.texi 2000/09/04 21:36:42
@@ -11,7 +11,10 @@
of free operating systems, as well as proprietary operating systems with
chain-loading@footnote{@dfn{chain-load} is the mechanism for loading
unsupported operating systems by loading another boot loader. It is
-typically used for loading DOS or Windows.}.
+typically used for loading DOS or Windows.}. GRUB is designed to
+address the complexity of booting a personal computer; both the
+program and this manual are tightly bound to that computer platform,
+although porting to other platforms may be addressed in the future.
One of the important features in GRUB is flexibility; GRUB understands
filesystems and kernel executable formats, so you can load an arbitrary
Index: user-ref.texi
===================================================================
RCS file: /cvs/grub/docs/user-ref.texi,v
retrieving revision 1.27
diff -u -d -u -r1.27 user-ref.texi
--- docs/user-ref.texi 2000/06/22 09:11:06 1.27
+++ docs/user-ref.texi 2000/09/04 21:36:43
@@ -254,7 +254,7 @@
partition when installing GRUB).
If you enabled the network support, the special drive, @samp{(nd)}, is
-also available. Before using the network drive, you must initiailze the
+also available. Before using the network drive, you must initialize the
network. @xref{Network}, for more information.
@@ -287,7 +287,7 @@
@end example
This represents that GRUB should read blocks 0 through 99, block 200,
-and blocks 300 through 600. If you omit an offset, then GRUB assumes
+and blocks 300 through 599. If you omit an offset, then GRUB assumes
the offset is zero.
Like the filename syntax (@pxref{Filename syntax}), if a blocklist does
@@ -754,7 +754,7 @@
@deffn Command tftpserver ipaddr
Override a TFTP server address returned by a BOOTP/DHCP/RARP server. The
-argument @var{ipaddr} must be in the standard format, like
+argument @var{ipaddr} must be in dotted decimal format, like
@samp{192.168.0.15}.
@end deffn
@@ -850,14 +850,12 @@
@deffn Command fstest
Toggle filesystem test mode.
-
Filesystem test mode, when turned on, prints out data corresponding to
all the device reads and what values are being sent to the low-level
routines. The format is @samp{<@var{partition-offset-sector},
@var{byte-offset}, @var{byte-length}>} for high-level reads inside a
partition, and @samp{[@var{disk-offset-sector}]} for low-level sector
requests from the disk.
-
Filesystem test mode is turned off by any use of the @command{install}
or @command{testload} commands.
@end deffn
Index: ChangeLog
===================================================================
RCS file: /cvs/grub/ChangeLog,v
retrieving revision 1.307
diff -u -d -u -r1.307 ChangeLog
--- ChangeLog 2000/09/03 05:08:50 1.307
+++ ChangeLog 2000/09/04 21:40:19
@@ -1,3 +1,8 @@
+2000-09-04 Alessandro Rubini <[EMAIL PROTECTED]>
+
+ * docs/tutorial.texi, docs/prog-ref.texi, docs/user-ref.texi:
+ fixed a few typos and minor imprecisions
+
2000-09-03 OKUJI Yoshinori <[EMAIL PROTECTED]>
* util/grub-install.in: Fix a typo: grub_dir -> grubdir.
