new chapter for the serial terminal support

[OKUJI Yoshinori]

  I have written a chapter for the serial terminal support right now,
since Gordon seems to be about to release 0.5.96. I hope this is not
too late. BTW, Gordon, we need to update the command references,
because we have added several new commands after 0.5.95. Can you do
that? Basically, you need to just cut and paste the descriptions from
stage2/builtins.c.

Index: ChangeLog
===================================================================
RCS file: /home/cvs/grub/ChangeLog,v
retrieving revision 1.326.2.2
diff -u -r1.326.2.2 ChangeLog
--- ChangeLog   2000/10/04 17:28:47     1.326.2.2
+++ ChangeLog   2000/10/05 01:43:47
@@ -1,3 +1,9 @@
+2000-10-05  OKUJI Yoshinori  <address@hidden>
+
+       * docs/grub.texi: Added an entry for the chapter "Serial
+       terminal".
+       * docs/tutorial.texi (Serial terminal): New chapter.
+       
 2000-10-04  Gordon Matzigkeit  <address@hidden>
 
        * docs/grub.texi: Remove braces from address@hidden' sections so
Index: docs/grub.texi
===================================================================
RCS file: /home/cvs/grub/docs/grub.texi,v
retrieving revision 1.39.4.1
diff -u -r1.39.4.1 grub.texi
--- docs/grub.texi      2000/10/04 17:28:49     1.39.4.1
+++ docs/grub.texi      2000/10/05 01:43:47
@@ -99,6 +99,7 @@
 * Installation::                Installing GRUB on your drive
 * Booting::                     How to boot different operating systems
 * Network::                     Downloading OS images from a network
+* Serial terminal::             Using GRUB via a serial line
 * Configuration::               Writing your own configuration file
 
 Part II: The User Reference Manual
Index: docs/tutorial.texi
===================================================================
RCS file: /home/cvs/grub/docs/tutorial.texi,v
retrieving revision 1.20
diff -u -r1.20 tutorial.texi
--- docs/tutorial.texi  2000/09/07 10:21:04     1.20
+++ docs/tutorial.texi  2000/10/05 01:43:47
@@ -726,6 +726,58 @@
 exact syntax should differ from the example, more or less.
 
 
address@hidden Serial terminal
address@hidden Using GRUB via a serial line
+
+This chapter describes how to use the serial terminal support in GRUB.
+
+If you have many computers or computers with no display/keyboard, it
+would be very useful to control the computers with serial
+communications. To connect a computer with another via a serial line,
+you need to prepare a null-modem (cross) serial cable, and you may need
+to have multiport serial boards, if your computer doesn't have extra
+serial ports. In addition, a terminal emulator is also required, such as
+minicom. Refer to a manual of your operating system, for more
+information.
+
+As for GRUB, the instruction to set up a serial terminal is quite
+simple. First of all, make sure that you haven't specified the option
address@hidden to the configure script when you built your
+GRUB images. If you get them in binary form, probably they have serial
+terminal support already.
+
+Then, initialize your serial terminal after GRUB starts up. Here is an
+example:
+
address@hidden
address@hidden
+grub> serial --unit=0 --speed=9600
+grub> terminal serial
address@hidden group
address@hidden example
+
+The command @command{serial} initializes the serial unit 0 with the
+speed 9600bps. The serial unit 0 is usually called @samp{COM1}, so, if
+you want to use COM2, you must specify @samp{--unit=1} instead. This
+command accepts many other options, so please refer to @ref{Commands},
+for more details.
+
+The command @command{terminal} chooses which type of terminal you want
+to use. In that case above, the terminal will be a serial terminal, but
+you can also pass @code{console} to the command, like @samp{terminal
+serial console}. In this case, a terminal in which you press any key
+will be selected as a GRUB terminal.
+
+However, note that GRUB assumes that your terminal emulator is
+compatible with VT100 by default. This is true for most terminal
+emulators nowadays, but you should pass the option @option{--dumb} to
+the command, if your terminal emulator is not VT100-compatible or
+implement few VT100 escape sequences. If you specify the option, then
+GRUB doesn't provide you with the menu interface, because the menu
+requires several fancy features for your terminal. Instead, GRUB only
+gives you the hidden menu interface and the command-line interface.
+
+
 @node Configuration
 @chapter Configuration