Document system

SEP's make rules provide standard commands to create the various document versions. When within the SEP environment (at an SEP computer or on a SEP CD-ROM), go to any SEP document, type one of the following commands, and inspect the various results:

gmake paper.ps

creates a Postscript file.

gmake paper.gs

displays a Postscript file with ghostview.

gmake paper.dvi

creates a standard DVI file.

gmake paper.read

creates the DVI file and displays it with xdvi.

gmake paper.print

creates the DVI file and prints it to the default printer.

gmake paper.ltx

converts an SEP style TEX file into a proper L^ATEX file, paper.ltx. The paper.ltx file is helpful for debugging since the line numbers of TEX's log file refer to it.

gmake paper.slide

creates a DVI file using an official slide macro set.

gmake paper.jslide

creates a standard SEP DVI file but with an reduced page width of about 40 characters. Jon Claerbout likes to make slides from this DVI file by enlarging the text on a copy machine.

A reader or author may want to try some of these more experimental document commands:

gmake paper.html

creates an HTML subdirectory (paper_html) that includes an HTML version of the L^ATEX paper. The make target will invoke the latex2html script. The rule uses standard X11 programs to generate the necessary .gif figures for equations and figures. We still have to define a set of adequate ``clean'' rules.

gmake paper.browse

updates the paper_html directory and starts-up a browser.

gmake paper.idvi

creates a DVI version that can be rendered by IDVI, a Java renderer. IDVI is an experimental alternative to latex2html.

gmake paper.xtex

displays a DVI file with xtex. This command uses an old set of SEP's L^ATEX macros. You may have to remove some new macros, such as keywords. Additionally, xtex does not find the activeplot figures correctly. In the near future, we probably have to remove the paper.xtex rule.

The targets above can be applied to text source files with any name, as long as the name ends with the suffix .tex. For example, to create a Postscript version from a text source file named mytext.tex, you execute make mytext.ps.

In general, the new L^ATEX2_e macros are backward compatible. You should be able to process any old SEP L^ATEX file with the new SEP L^ATEX2_e macros. The only known backward incompatibility is that the new activeplot macro always requires a width or height statement.

To ease the maintenance of reproducible documents, we improved the communication between the document's makefile and its L^ATEX file. Consequently, the author does not need to define the result directory in the L^ATEX file (previously: \def\figdir{name}.) Instead, the new document processing system requests that information from your makefile. Try processing an old SEP L^ATEX document after removing the figdir statement.

A SEP L^ATEX2_e document forces an author to supply a keyword list with the help of the macro \keywords{}. The keyword list is printed below the list of authors and will help us to index SEP documents in the future. We are planning to supply a set of keywords that an author can choose from (e.g., the SEG keywords for expanded abstracts.)

Finally, we added an enhanced clean rule, jdistclean, to our standard make rules. The distclean rule creates a minimal set of files: In addition to the intermediate files that are removed by the clean rule, it also removes all reproducible result files and any HTML directories.