Imported Upstream version 23.2

[rrq/maintain_lilo.git] / doc / README

diff --git a/doc/README b/doc/README
index 31b5ec7e404e5f664eeae8f53181473896eee641..e7c2cc84780e4587fd5a1e19a50989d0fda32160 100644 (file)
--- a/doc/README
+++ b/doc/README
@@ -1,16 +1,3 @@
-Generating the README
-=====================
-
-In order to (re)generate the plain ASCII documentation that is found in
-lilo/README, Perl 4 or 5 must be installed on your system.
-Just type
-
-make ../README
-
-to perform the conversion. Note that fairly large amounts of virtual memory
-(16 MB or more) are allocated during the process.
-
-

 Printing the documentation
 ==========================
 
 Printing the documentation
 ==========================
 


@@ -29,28 +16,34 @@ are only necessary when processing the technical overview document.
 
 To run LaTeX just type
 
 
 To run LaTeX just type
 

-make
+  make

 
 LaTeX issues many "Overfull \hbox" warnings. They can be safely ignored.
 LaTeX will be run repeatedly until it stops issuing the message
 
 LaTeX issues many "Overfull \hbox" warnings. They can be safely ignored.
 LaTeX will be run repeatedly until it stops issuing the message

-LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right.
+LaTeX Warning: Label(s) may have changed. Rerun to get cross-references 
+right.
+
+At the end you should get the very old documentation in user.pdf and 
+tech.pdf.
+
+Generating user.README
+======================
+
+Use the simple tool t2a.pl for converting to ASCII formatted (old) user
+documentation:
+
+  perl t2a.pl  <user.tex  >user.README

 
 

-Finally, you have to convert the device-independent file doc.dvi to
-something your printer understands. The actual command to perform this
-depends on your local installation. Example:
+Online documentation
+====================

 
 

-dvips user | lpr
+The (old) documentation can also be found in the web:

 
 

-(Another way is to use GhostScript. To generate HP DeskJet output by
-converting the DVI file to PostScript as an intermediate step, use this
-command
+http://lilo.alioth.debian.org/olddoc/html/user_21-5.html
+http://lilo.alioth.debian.org/olddoc/pdf/user_21-5.pdf

 
 

-dvips -r1 -f1 user | gs -q -sDEVICE=deskjet -sOutputFile=/dev/lp1 -
+http://lilo.alioth.debian.org/olddoc/html/tech_21-5.html
+http://lilo.alioth.debian.org/olddoc/pdf/tech_21-5.pdf

 
 

-gs -h  lists all configured drivers.)

 
 

-If you don't have access to LaTeX but if you can print PostScript, you
-should get the file(s) lilo.<part>.<version>.ps.gz from the same place
-where you've obtained lilo.<version>.tar.gz  That file contains the
-document user.tex (<part> = u) or tech.tex (<part> = t) already translated
-to PostScript.
+-- Joachim Wiedorn (2011)