From bc61b4d21facbe82862dec188438e8d1629e3161 Mon Sep 17 00:00:00 2001 From: okuji Date: Sun, 2 Jul 2000 04:03:25 +0000 Subject: [PATCH] update the docs. --- ChangeLog | 6 ++++++ INSTALL | 12 +++++++----- README | 15 ++++++++++++--- docs/appendices.texi | 9 ++++----- 4 files changed, 29 insertions(+), 13 deletions(-) diff --git a/ChangeLog b/ChangeLog index aa1746cf0..dc2f01be0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2000-07-02 OKUJI Yoshinori + + * docs/appendices.texi (Obtaining and Building GRUB): Indicate + the Cygnus's binutils webpage instead of the hjl's site, since + you can now use a public release (i.e. 2.10). + 2000-06-23 OKUJI Yoshinori * stage2/boot.c (load_image): Take an additional argument diff --git a/INSTALL b/INSTALL index 764eb262a..86e35f126 100644 --- a/INSTALL +++ b/INSTALL @@ -25,11 +25,13 @@ configuring the GRUB. * GNU binutils 2.9.1.0.23 or later Binutils has changed the behavior of 16bit assembler between 2.9.1 - and 2.9.1.0.x, and we support only 2.9.1.0.x and higher. It is - available from - . You don't have - to install it into a system directory. See the section "Operation - Controls". + and 2.9.1.0.x, and we support only 2.9.1.0.x and higher. In + particular, we recommend using binutils 2.10, since it is the only + public release that supports real 16bit mode. Please taka a look at + the webpage , for more + information. Note that you don't have to install it into any system + directory. See the section "Operation Controls", if you want to + install binutils into your own directory. If you'd like to develop GRUB, these below are also required. Don't forget to specify the option `--enable-maintainer-mode' when running the diff --git a/README b/README index a560cf3a7..c9c4187f3 100644 --- a/README +++ b/README @@ -27,10 +27,19 @@ If you have any suggestions or ideas, please send electronic mail to the GRUB mailing list . The archive of the list is available at . -When you encounter any problem or bug, please submit it to +When you encounter a problem or a bug, first of all, read the chapter +"Reporting bugs" in the document. Very often, people ask us their +questions with little (or no) information about their systems. That's +quite useless, because we have to *guess* what you did, what was +displayed and what really happened. Please notice that we may not see +your computer directly. So, whenever you report a bug, you must include +enough information so that we can understand what happened and even +reproduce your problem in our machines. + +Once you have realized how to write a bug report, please submit it to with information about your computer and what you did -as much as possible. For example, your operating system and the -geometries of your drives are very important. +_as much as possible_. Excessive information is always better than no +information. When you enhance/fix GRUB, please send the patch to . Do not forget to write your changes to ChangeLog; That helps us to diff --git a/docs/appendices.texi b/docs/appendices.texi index fa908e854..ed576b587 100644 --- a/docs/appendices.texi +++ b/docs/appendices.texi @@ -157,10 +157,9 @@ utopia@dots{} @quotation @strong{Caution:} GRUB requires binutils-2.9.1.0.23 or later because the GNU assembler has been changed so that it can produce real 16bits -machine code between 2.9.1 and 2.9.1.0.x. The latest version can be -obtained from: - -@url{ftp://ftp.varesearch.com/pub/support/hjl/binutils/} +machine code between 2.9.1 and 2.9.1.0.x. See +@url{http://sourceware.cygnus.com/binutils/}, to obtain information on +how to get the latest version. @end quotation @c Do not change alpha.gnu.org:/gnu/grub to the URI, since TeX does @@ -178,7 +177,7 @@ To unbundle GRUB use the instruction: zcat grub-@value{VERSION}.tar.gz | tar xvf - @end example -which will create a directory called @file{guile-@value{VERSION}} with +which will create a directory called @file{grub-@value{VERSION}} with all the sources. You can look at the file @file{INSTALL} for detailed instructions on how to build and install GRUB, but you should be able to just do: