Book or Thesis

Like all SEP documents, a book or thesis is a UNIX directory tree. Its top directory includes usually following subdirectories:

• Adm includes all kind of administrative files. The directory has to contain all.tex, DOCNAME.csh, and DOCNAME.dvi. (DOCNAME is the capitalized name of the document, such as TDF, or SEP86.) The central rule in the Adm Makefile is install-to-read. If you need to create such an Adm directory than copy and modify one of an older document and talk to the person in charge for TEX. Every document needs an Adm directory.
• Dvi stores the documents dvi file. The file name is DOCNAME.dvi. The Makefile rule install-to-read in the Adm directory installs the dvi file in this directory. Every document needs an Dvi directory.
• Lib stores the source code for a subroutine library and a Makefile which manages the library updates. Such a library becomes necessary when several chapters (see below) share subroutines.
• Src stores the source code for a set of main routines and a Makefile that manages the corresponding executables. Such a source directory becomes necessary when several chapters share common main routines.
• Bin stores executables shared by several chapters. The corresponding source code resides in the Src directory.
• Data contains data sets which are shared between different chapters. The data sets comprise the header and data file and should probably combine them into a single file to avoid possible absolute path name definitions (see below).
• chap1 corresponds to the chapter of a conventional book. A book or thesis contains usually a set of chapters. Each chapter is independent of all the other ones except the shared files in the Lib, Src, Bin, and Data directory. Depending on the complexity of its contents such a chapter directory can vary in its structure. In the next paragraph, I give a standard example.