* * TTTTTTT X X M M GGGGGG A Mostly Unofficial * * T X X MM MM G Publication for Users * * T EEEEEEE XXX M M M M A G GG Of the TeX Computer * * T E X X M M M A A G G Typesetting System. * * T EEEE X X M M M AAAAA GGGGGG * * E A A Volume 1, Number 6 * * EEEEEEE A A Distribution: 316 or so... * * * ******************************************************************************* August 24, 1987 Contents: \footnote............................................................1 Letters to the Editor................................................2 Last 1987 TeX courses................................................3 Table of Contents for TUGboat 8#2....................................4 A quick guide to the standard WEB programs...........................5 The Toolbox..........................................................6 __1 \footnote{Uniquely qualified to bring you the world} Well, here I am again, with the latest TeXMaG. Now that I finished the previewer I was writing (more on that next issue), I can finally sit back and relax by frantically typing another \footnote. This issue is another one of those ``Slow day in the college world'' issues, but without the harping on the ``please will you write an article for me'' theme. In the line-up is an announcement about an up-coming TeX class at the University of Illinois at Chicago; the contents of the latest TUGboat which is already in the hands of just about everybody by now (one of these days, I'll get it out before TUGboat does), and some information on all the mysterious WEB files that come with TeX. I'm going back to California as most of you probably already know, so remember that I'm back at for the next nine months or so. G'day -Dh __2 *Letters to the Editor* Date: Thu, 6-AUG-1987 15:29 EDT From: "Rouben Rostamian, Mathematics, x2458" Subject: The resume macro for TeX Dear Don: I used your resume macro for TeX from one of the recent issues of TeXMaG. I like it and I will use it. There seems to be a minor problem in it which I cannot fix (I am not very comfortable with TeX commands). As I understand it, the definition of \endtag is supposed to put a horizontal space of 0.1in between TAG and INFO. (The values supplied in your version are \hsize=6.5truein \TAGboxhsize=1.0truein \INFOboxhsize=5.4truein and 1.0 + 0.1 + 5.4 = 6.5 ! When I use the macro, what happens is that the 0.1in spacing between the horizontal boxes appears at the right of the INFO box rather than at its left. Therefore there is no space between the TAG and INFO. This becomes a problem when the width of the TAG is close to 1.0in. Just wanted to let you know. Thanks for your TeXMaG Rouben Rostamian [[Editor's note: there was a bug in the macro as published which is easily corrected; in the definition for \endtag the lines \tabskip=0.1in \valign{##\vfill\cr \box\TAGbox\cr \box\INFObox\cr}} should be replaced with \valign{##\vfill\cr \box\TAGbox\cr \noalign{\hfill} \box\INFObox\cr}} The \tabskip of the original definition was being applied to the space *above* and *below* the resume entries resulting in the lack of space between the tags and the info, as well as putting an extra 0.2in of space between entries. (whoops).]] __3 *Last 1987 TeX Courses* The TeX Users Group will be offering Intermediate TeX on Sept. 14--18 and Advanced TeX/Macro Writing on September 14--18 at the University of Illinois at Chicago campus. The fee for the five day course is $700. If your university is an institutional member, members of the faculty, staff or student body are entitled to a 10 percent discount. To register, or for more information about these courses, write or call: TeX Users Group P.O. Box 9506 Providence, R.I. 02940 (401) 272-9500, ext. 232 __4 *Table of contents for TUGboat 8#2* (Barbara Beeton) General Delivery Bart Childs From the President Gideon~Koren How to improve the chances for acceptance of your scientific paper Software James Alexander Tib: a reference setting package, update 2< Pedro de Rezende Portuguese hyphenation table for TeX Michael Ferguson A (hopefully) final extension of multilingual TeX Yasuki Saito Report on JTeX: A Japanese TeX E. Wayne Sewell Multiple changefiles: the adventure continues E. Wayne Sewell How to MANGLE your software: the WEB system for Modula-2 E. Wayne Sewell The SCANTEX processor Fonts John S. Gourlay Blacker Thoughts John Sauter Updated Computer Modern fonts for the LN03 John Crawford MFtool: A MetaFont script-driven processing facility Barbara Beeton Update: MetaFont mode_def settings for TeX output devices Donald E. Knuth Fonts for digital halftones Output Devices Robert W. McGaffey The ideal TeX driver Don Hosek TeX output devices (with charts) Alec Dunn Using PostScript with TeX Index to sample output from various devices Site Reports Glenn L. Vanderburg TEX-L access for Bitnet users Laurie Mann TeX and training: A case study Data General: Bart Childs Data General site report IBM VM/CMS: Dean Guenther IBM VM/CMS site report Gil Pierson SAS merged with TeX UNIX: Pierre MacKay Unix TeX site report VAX/VMS: Adrian F. Clark Enhancements to TeX on the VAX Typesetting on PCs Gerhard F. Kohlmayr A bug in TeXtures v0.95 prerelease Barry Smith Work-around for an ImageWriter problem affecting TeXtures output Alan Hoenig Update: Real typesetting from your PC & Mitch Pfeffer Macros Wolfgang Appelt Macros with keyword parameters Alois Kabelschacht \expandafter in conditionals; a generalization of PLAIN's \loop Elizabeth Barnhart TeX in the commercial environment--- multi-column output Charles LeHardy Diglot typesetting Anne Bruggemann-Klein First line special handling with TeX LaTeX Ken Yap Contents of LaTeX style collection as of 15th May 1987 Richard Aurbach Automated index generation for LaTeX Problems Donald Knuth Saturday morning problem---solution Alan Hoenig TeX does windows---conclusion Jim Fox Comment on ``TeX does windows'' Queries James Alexander Time line macro Donald Knuth Reply: Printing out selected pages Mike Black Using the Windows environment News & Announcements TUG Annual Meeting: University of Washington, August 24-26, 1987 Calendar Boston, Mass., 22-24 October 1987: PROTEXT IV University of Munster, 8-9 October 1987: 6th German TeX meeting 22 Late-Breaking News Lynne A. Price SGML and TeX TUG Business Samuel B. Whidden Treasurer's report __5 *A quick guide to the standard WEB programs with TeX* By Don Hosek Scattered about in assorted directories in most TeX distributions are large numbers of WEB and CH files that mean very little to most people. While a delving into the deeper meanings of WEB is best put off for some other time, an explanation of the programs themselves is at least interesting. Before we begin, a little background about the WEB system may be useful, i.e., how to deal with the WEB files. Two things may be done to a WEB program: it may be TANGLEd which is the first step on the road to creating an executable program, or it may be WEAVEd (woven?) which is the first step in producing a formatted listing of the program. Assuming that you are using a generic WEB system (Pascal and TeX: there also exist WEBs that use C/nroff, C/TeX, and Modula 2/TeX), you will follow a series of steps that looks vaguely like the following to generate an executable module: TANGLE fn PASCAL fn where fn is the name of the file that you wish to TANGLE. Creating a formatted listing is a similar process: WEAVE fn TEX fn before you run TeX, though you may wish to make sure that the TeX file does not contain requests for non-available fonts. For example, one commonly loaded font is manmac (or logo). If this font is not available, I usually replace it with cmssq8 at 9.6pt which provides an acceptable substitute for typesetting the Metafont logo. Another thing you may wish to check for in the TeX file generated by WEAVE is the command \let\maybe=\iffalse. If this command is present in the TeX file, only those portions of the WEB file that have been changed will be printed. This is useful for a long program such as TEX.WEB, but in the case of a shorter program such as DVITYPE that you are more interested in seeing the whole program, you will probably want to remove that definition. For more information on the WEB system, the files WEBMAN.TEX and WEB.TEX provide much useful information. Now that you have a basic understanding of what may be done with a WEB file, we will give a listing of the WEB files that come with most TeX distributions, what they do, and why they're interesting. DVIIMP.WEB (Arthur Samuel) A model device driver for the Imagen laser printer. DVITYPE (below) is the ``official'' model of how to deal with the subtleties of reading and interpretting DVI files, but DVIIMP provides a working (well, only if you have a DEC-20 or a change file) model of how to actually read DVI and GF files to produce printable output. Most distributions do not come with change files for this program. DVITYPE.WEB (Donald Knuth) The official source of information on reading and interpretting DVI files. Included are instructions on rounding measurements in a device independant manner, and a complete description of standard DVI file commands. Most DVI-to-whatever drivers are based directly on DVItype (for example DVIIMP, above). The program is also helpful for checking the validity of DVI files. GFREAD.WEB (Tomas Rokicki) Example code for reading GF font files. The program is intended more as an example than a utility and the code was written to make it easy to replace PXL-reading code in old device drivers by GF-reading code. GFTODVI.WEB (Donald Knuth) A utility program for producing proof sheets of Metafont-generated fonts. The program is documented in one of the appendixes of the MetafontBook. This program provides a good example of reading GF files containing special commands; it is not, however, a desirable GF-reading model for device drivers. GFTOPK.WEB (Tomas Rokicki) A utility program for converting GF font files generated by Metafont to PK font files which take half the space of GF files. A good example of both reading GF files and writing PK files. GFTOPXL.WEB (Arthur Samuel) A utility program for converting GF font files generated by Metafont to PXL font files which are large and ineffecient (the program justifies its existence by citing the existence of ``old'' drivers). The program includes information on the format of GF and PXL files. GFTYPE.WEB (David Fuchs) A utility for examining carefully the contents of GF files. The program includes information on the format of GF files and serves as a model GF-reading program. PATGEN.WEB A program that given a list of hyphenated words, is capable of generating a set of hyphenation patterns for use by TeX82's hyphenation algorithim. PKTOPX.WEB A utility program for converting PK files to PXL format. serves as a model for reading PK files and for writing PXL files. It also includes information on the PK and PXL formats. PKTYPE.WEB (Tomas Rokicki) A utility program for reading PK files and displaying their contents symbolicly. It serves as a model for reading PK files and includes information on the PK format. PLTOTF.WEB (Donald Knuth) A utility program that converts font metric information in symbolic (PL=Property List) form to a TFM file. Useful for hand-generating TFM files for fonts not created using Metafont. POOLTYPE.WEB (Donald Knuth) A utility program that prints a string pool (such as that used by TeX or Metafont) to a symbolic form. Useful for debugging WEB programs that use the string pool facility. It is also provided as a ``first'' program to attempt writing a change file for due to its simplicity. PXTOPK.WEB A utility program for converting PXL files to PK files. It provides an example of reading information from a PXL file as well as information on writing information to a PK file. Information on the PK and PXL formats is included in the program. TFTOPL.WEB (Donald Knuth) A utility program that converts a TFM file to a symbolic form (PL---see PLTOTF above). It gives the complete format for a TFM file as well as serving as a means for debugging and semi-automatic cleaning of TFM files. __6 *The Toolbox* From Barbara Beeton A couple of issues back, you included the macros \dlap and \ulap with a comment that you'd like to see some real use for them. well, I'm just now implementing a new journal style, the hallmark of which is top and bottom rules precisely 60.5pc apart. In order to ensure the required precision, it's easiest to treat the whole structure as a running head. There's text above the top line and more text below the bottom line. Here's a paraphrase of plain's \makeheadline that would do approximately what's needed. %%%---------------Cut here-------------------------------------------- \def\makeheadline{\vbox to 0pt{kern-3pc \hrule height.5pt depth0pt \ulap{\centerline{\strut\headline}\kern2pt}% \dlap{\kern60.5pc \hrule height.5pt depth0pt \baselineskip=12pt \footline}\nointerlineskip} %%%---------------Cut here-------------------------------------------- Note that, if the \ulap does not end with glue, the depth of the last element in it will become the depth of the box, and will add vertical space where none is wanted. [[Editor's note: here are the original definitions for \ulap and \dlap]] %%%---------------Cut here-------------------------------------------- \catcode`\@=11 \long\def\ulap#1{\vbox to \z@{\vss#1}} \long\def\dlap#1{\vbox to \z@{#1\vss}} \catcode`\@=12 %%%---------------Cut here-------------------------------------------- __7 TeXMaG is an electronic magazine published by the Harvey Mudd College Mathematics Department available free of charge to all interested parties reachable by electronic mail. It is published monthly, on the last weekend of each month, except when conditions prevent publication. Subscription requests should be sent to Don Hosek or send the following message to LISTSERV@BYUADMIN: SUBS TEXMAG-L Your_Full_Name. European subscribers may send the SUBS command to LISTSERV@DEARN, subscribers on CDNnet should send subscription requests to , and JANET subscribers should send requests to be added to the list to Peter Abbott, . Back issues are available for anonymous FTP in the file BBD:TEXMAG.TXT on SCIENCE.UTAH.EDU. They may also be obtained from Don Hosek . Article submissions, contributions for the Toolbox, and letters to the editor are always welcome and should be sent to . Other publications of interest to TeX users are: TeXHAX. Arpanet mailing list for persons with questions, suggestions, etc.. about TeX, LaTeX, metafont and related programs. Submissions for this list should be sent to . BITNET users may subscribe by sending the following command (as an interactive message or as the first line of a mail message) to LISTSERV@TAMVM1: SUBS TEX-L your_full_name. The list is peer-linked to other listserves in the United States and Europe. Internet subscribers may subscribe by sending a request to . The TeX-L mailing list is a ``hybrid;'' i.e., it is both an ARPAnet redistribution, and a BITNET discussion list. Submissions for TeX-L (only --- they will _not_ be forwarded to TeXHAX) may be sent to TeX-L@TAMVM1. LISTSERV@TAMVM1 also has file archives that may be of interest to TeX users on BITNET, including the files in the SU-SCORE FTP directories and back issues of TeXHAX. For a list of files available, send the following command to LISTSERV@TAMVM1: GET TeX FILELIST. Unix-TeX. Arpanet mailing list specifically for users of TeX under the Unix operating system. Submissions for this list should be sent to . Requests to be added or deleted from the mailing list should be sent to . TUGBoat. A publication by the TeX Users Group. An excellant reference for TeX users. For more information about joining TUG and subscribing to TUGBoat send (real) mail to: TeX Users Group c/o American Mathematical Society P. O. Box 9506 Providence, RI 02940-9506, USA Special thanks to Dean Guenther for being a generally nice person, Ned Freed for putting up with me, and Barbara Beeton, for printing my name not once, but three times in the last TUGboat.