www.delorie.com/gnu/docs/calc/calc_376.html   search  
Buy the book!

GNU Emacs Calc 2.02 Manual

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

A.11 Printed Documentation

Because the Calc manual is so large, you should only make a printed copy if you really need it. To print the manual, you will need the TeX typesetting program (this is a free program by Donald Knuth at Stanford University) as well as the `texindex' program and `texinfo.tex' file, both of which can be obtained from the FSF as part of the texinfo2 package.

To print the Calc manual in one huge 550 page tome, type `make tex'. This will take care of running the manual through TeX twice so that references to later parts of the manual will have correct page numbers. (Don't worry if you get some "overfull box" warnings.)

The result will be a device-independent output file called `calc.dvi', which you must print in whatever way is right for your system. On many systems, the command is

lpr -d calc.dvi

Marginal notes for each function and key sequence normally alternate between the left and right sides of the page, which is correct if the manual is going to be bound as double-sided pages. Near the top of the file `calc.texinfo' you will find alternate definitions of the \bumpoddpages macro that put the marginal notes always on the same side, best if you plan to be binding single-sided pages.

Some people find the Calc manual to be too large to handle easily. In fact, some versions of TeX have too little memory to print it. So Calc includes a calc-split-manual command that splits `calc.texinfo' into two volumes, the Calc Tutorial and the Calc Reference. The easiest way to use it is to type `make tex2' instead of `make tex'. The result will be two smaller files, `calctut.dvi' and `calcref.dvi'. The former contains the tutorial part of the manual; the latter contains the reference part. Both volumes include copies of the "Getting Started" chapter and licensing information.

To save disk space, you may wish to delete `calctut.*' and `calcref.*' after you're done. Don't delete `calc.texinfo', because you will need it to install future patches to Calc. The `make tex2' command takes care of all of this for you.

The `make textut' command formats only the Calc Tutorial volume, producing `calctut.dvi' but not `calcref.dvi'. Likewise, `make texref' formats only the Calc Reference volume.

Finally, there is a calc-split-summary command that splits off just the Calc Summary appendix suitable for printing by itself. Type `make summary' instead of `make tex'. The resulting `calcsum.dvi' file will print in less than 20 pages. If the Key Index file `calc.ky' is present, left over from a previous `make tex' command, then `make summary' will insert a column of page numbers into the summary using that information.

The `make isummary' command is like `make summary', but it prints a summary that is designed to be substituted into the regular manual. (The two summaries will be identical except for the additional column of page numbers.) To make a complete manual, run `make tex' and `make isummary', print the two resulting `.dvi' files, then discard the Summary pages that came from `calc.dvi' and insert the ones from `calcsum.dvi' in their place. Also, remember that the table of contents prints at the end of the manual but should generally be moved to the front (after the title and copyright pages).

If you don't have TeX, you can print the summary as a plain text file by going to the "Summary" node in Calc's Info file, then typing M-x print-buffer (see section C. Calc Summary).


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2003   by The Free Software Foundation     Updated Jun 2003