Next: Books and reports Up: Fomel et al.: Empowering Previous: DOCUMENT EXAMPLE

# 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.
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 LATEX 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 LATEX 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 LATEX 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 LATEX2e macros are backward compatible. You should be able to process any old SEP LATEX file with the new SEP LATEX2e 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 LATEX file. Consequently, the author does not need to define the result directory in the LATEX file (previously: \def\figdir{name}.) Instead, the new document processing system requests that information from your makefile. Try processing an old SEP LATEX document after removing the figdir statement.

A SEP LATEX2e 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.

Next: Books and reports Up: Fomel et al.: Empowering Previous: DOCUMENT EXAMPLE
Stanford Exploration Project
11/11/1997