X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=doc%2FREADME;h=e7c2cc84780e4587fd5a1e19a50989d0fda32160;hb=cb96d5824e301ed96ca68f3f21ceb0d4839f37ba;hp=31b5ec7e404e5f664eeae8f53181473896eee641;hpb=23c77cc092dbbb1e12c47c2b0021d4476b543702;p=rrq%2Fmaintain_lilo.git diff --git a/doc/README b/doc/README index 31b5ec7..e7c2cc8 100644 --- 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 ========================== @@ -29,28 +16,34 @@ are only necessary when processing the technical overview document. 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 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.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...ps.gz from the same place -where you've obtained lilo..tar.gz That file contains the -document user.tex ( = u) or tech.tex ( = t) already translated -to PostScript. +-- Joachim Wiedorn (2011)