LogonBook

Background

This page (or possibly set of pages below LogonBook) serves a purpose internal to the LOGON project: help contributors to the final LOGON book coordinate their efforts. We expect to collect a complete initial set of chapters before the summer of 2007; these pages will be continuously updated with instructions to authors, specifically style recommendations and LaTeX information.

Collaborative Authoring

The LOGON book project will be compiled in LaTeX, with all source files organized in CVS version control; please consult the pages LogonInstallation/CvsBasics and LogonInstallation/InstallationBasics for background.

The main difference to our use of CVS in past development of the LOGON demonstrator is the name of the top-level CVS module. Instead of the module named logon, all book files are organized as a module named book. Thus, the following should yield a complete initial LaTeX tree:

  cvs -d :pserver:oe@cvs.emmtee.net:/logon/CVS checkout book

Remember to substitute your LOGON work space user name for oe in this example.

Once the checkout from CVS is complete, there will be a new directory book/' with sub-directories planning/' and `submission/'. Initial chapter versions that will go into the peer reviewing phase reside in the `submission/' directory, with yet another sub-directory for each chapter. Take a look at the top-level LaTeX file `master.tex' to understand the directory structure and naming conventions. The only change(s) you should have to make to this file is in the \includeonly section, where removing the LaTeX comment character (which is the per cent sign) before each chapter name will activate inclusion of that chapter. When, to get started, you add an abstract for a chapter for which you are the primary author, say the chapter named fundamentals (with helge as the lead author), uncomment the corresponding line in `master.tex' and add your text to the file fundamentals/chapter.tex.

To typeset and preview your contributions, run latex on the master file, or (as a short-hand for the sequence of running both LaTeX and BibTeX as many times as is needed to include bibliographic references et al.) simply invoke the following within the submission/ directory:

  make

Common Acronyms and Abbreviations

Bibliographic References