From lechner@cs.uml.edu Sun Aug 20 18:33:10 2006 Subject: latex help online, and a .tex to .ps process walkthru To: sfrye@cs.uml.edu (Scot Frye) RJLRef: $CASE/latex/latex2psWalkthru060820.txt For online help on LaTex, See $CASE/latex = /usr/proj3/case/latex We never used Tex directly - only LaTex, which has higher-level macros. (I can loan you Tex and LaTex reference texts.) Below I also walk thru the .tex to .ps dataflow path. Sorry I didn't use the ltang pah as I intended. ------------------------ mercury(145)> case /nfs/galaxy/misc/proj3/case mercury(146)> lg latex total 256 drwxr-xr-x 2 7021 4096 Feb 27 1998 . drwxr-xr-x 162 fac 8192 Feb 11 2006 .. -rwxr-xr-x 1 fac 163 May 20 1993 aareadme -rwxr-xr-x 1 7021 1807 Feb 27 1998 latexreporthelp.aux -rwxr-xr-x 1 7021 89 Feb 27 1998 latexreporthelp.dlog -rwxr-xr-x 1 fac 16376 Feb 27 1998 latexreporthelp.dvi -rwxr-xr-x 1 7021 1133 Feb 27 1998 latexreporthelp.log -rwxr-xr-x 1 7021 122959 Feb 27 1998 latexreporthelp.ps -rwxr-xr-x 1 fac 21230 May 20 1993 latexreporthelp.tex -rwxr-xr-x 1 fac 643 Apr 30 1992 latex_template.tex -rwxr-xr-x 1 fac 2715 Apr 30 1992 template.tex -rwxr-xr-x 1 fac 128 Apr 30 1992 trailer.tex -------------------------------- I presume there may be .tex to .doc converters around now? .ps (and .pdf?) are useless if they can't be maintained. But LaTex wil survive because much math publishing uses it. We have a documentation gap betwen early bde/doc and later bde projects which use .doc but didn't include .tex predecessors. chgen was better at subsuming earlier versio docs, but still in .tex. On mercury I could run latex in ltang/bde/doc (symlink):: ------ OOPS! By mistake I ran these commands in the wrong directory --------- mercury(197)> pwd /nfs/galaxy/misc/proj3/case/gen/ver_13/chgen/doc mercury(198)> ----------- instead of in ltang's symlink to 95sbde. So the initial .tex file was a chgen report, to which I mistakenlhy created the link 93subdefinalreport.tex -> final_doc.tex The following 93subdefinalreport.* files are not bde reports at all.:-( but they illustrate the tex to ps data flow path and commands (on saturn not mercury): So I also created 93subdefinalreport.aareadme - RJL060820 to explain this before I later destroy these files (not wanting to go thru tis all over again:-) ------------ latex 93subdefinalreport.tex and got lots of 'Overfull \hbox (54.60022pt too wide) ..' errors but got a .dvi output: -------1 mercury(173)> lst total 604 12 -rw------- 1 lechner fac 5790 Aug 20 17:48 93subdefinalreport.aux 72 -rw------- 1 lechner fac 65036 Aug 20 17:48 93subdefinalreport.dvi 36 -rw------- 1 lechner fac 30861 Aug 20 17:48 93subdefinalreport.log 12 -rw------- 1 lechner fac 4684 Aug 20 17:48 93subdefinalreport.toc 8 drwxr-xr-x 5 lechner 05f523 4096 Aug 20 17:47 . ---------- (run latex again to insert the .toc file into the .dvi file; note .dvi file size expanded below):) mercury(177)> latex 93subdefinalreport.tex ... verfull \hbox (54.60022pt too wide) in paragraph at lines 1392--1392 [] \OT1/cmtt/m/n/12 table elements are added to the database via a cal l to pr_add.[] [42] (./93subdefinalreport.aux) ) (see the transcript file for additional information) Output written on 93subdefinalreport.dvi (43 pages, 78796 bytes). Transcript written on 93subdefinalreport.log. mercury(176)> ------------ mercury(176)> lst total 620 12 -rw-r--r-- 1 lechner fac 5791 Aug 20 17:51 93subdefinalreport.aux 88 -rw-r--r-- 1 lechner fac 78796 Aug 20 17:51 93subdefinalreport.dvi 36 -rw-r--r-- 1 lechner fac 30852 Aug 20 17:51 93subdefinalreport.log 12 -rw-r--r-- 1 lechner fac 4685 Aug 20 17:51 93subdefinalreport.toc 8 drwxr-xr-x 5 lechner 05f523 4096 Aug 20 17:47 . 4 lrwxrwxrwx 1 lechner fac 13 Aug 20 17:43 93subdefinalreport.tex -> final_doc.tex ... ----------- mercury(177)> xdvi 93subdefinalreport.dvi On mercury, xdvi opens a window displaying this file (43 pages). (no print option; no inserted diagrams) I don't think that report had diagrams - doc/idraw in 95sbde has STD's from Brian Barry's team plus earliere ones. ---------- mercury(179)> dvips 93subdefinalreport.dvi This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com) ' TeX output 2006.08.20:1751' -> |lpr <0ef0afca.enc>lpr: error - PRINTER environment variable names non-existent destination "laser2"! Broken pipe mercury(181)> dvips 93subdefinalreport.dvi>93subdefinalreport.ps This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com) ' TeX output 2006.08.20:1751' -> |lpr <0ef0afca.enc>lpr: error - PRINTER environment variable names non-existent destination "laser2"! Broken pipe mercury(182)> man dvips says: ------- NAME dvips - convert a TeX DVI file to PostScript SYNOPSIS dvips [ options ] file[.dvi] DESCRIPTION THIS MAN PAGE IS OBSOLETE! See the Texinfo documentation instead. You can read it either in Emacs or with the standalone info program which comes with the GNU texinfo distribution as prep.ai.mit.edu:pub/gnu/texinfo*.tar.gz. ... -f Run as a filter. Read the .dvi file from standard input and write the PostScript to standard output. The standard input must be seekable, so it cannot be a pipe. If you must use a pipe, write a shell script that copies the pipe output to a temporary file and then points dvips at this file. This option also disables the automatic reading of the PRINTER environment variable, and turns off the automatic sending of control D if it was turned on with the -F option or in the configuration file; use -F after this option if you want both. ... ---------- The -f option is needed top avoid complaints about printer env'ment: mercury(186)> dvips -f 93subdefinalreport.dvi > 93subdefinalreport.ps This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com) ' TeX output 2006.08.20:1751' -> <0ef0afca.enc><09fbbfac.enc> . [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23] [24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38] [39] [40] [41] [42] mercury(187)> lst total 844 8 drwxr-xr-x 5 lechner 05f523 4096 Aug 20 18:06 . 224 -rw------- 1 lechner fac 220508 Aug 20 18:06 93subdefinalreport.ps 12 -rw-r--r-- 1 lechner fac 5791 Aug 20 17:51 93subdefinalreport.aux 88 -rw-r--r-- 1 lechner fac 78796 Aug 20 17:51 93subdefinalreport.dvi 36 -rw-r--r-- 1 lechner fac 30852 Aug 20 17:51 93subdefinalreport.log 12 -rw-r--r-- 1 lechner fac 4685 Aug 20 17:51 93subdefinalreport.toc 4 lrwxrwxrwx 1 lechner fac 13 Aug 20 17:43 93subdefinalreport.tex -> final_doc.tex ... ------------- The command saturn.cs.uml.edu(18)> ghostview 93subdefinalreport.ps worked but says that it opened 93subdefinalreport.dvi, not .ps! ------------ BTWay, by mistake I ran these commands in the wrong directory mercury(197)> pwd /nfs/galaxy/misc/proj3/case/gen/ver_13/chgen/doc mercury(198)> i----------- instead of in ltang's symlink. So the initial .tex file was a chgen report, to which I mistakenlhy created the link 93subdefinalreport.tex -> final_doc.tex So these 93subdefinalreport.* files are not bde reports at all.:-(