#this is the driver file for a typical issue

#the issue command line should specify the same year and number as the file name;
#
#the way category, paper, and format command lines work should be self explanatory;
#    later we can change the syntax of these command lines if it is better to delimit fields in some other way;
#the "file name" is actually the directory in which the paper resides;
#    the files are assumed to be in the folder with the name year-i where i is the issue number;
#
#everything on a line after a sharp sign is ignored
#blank lines are ignored
#  \ as the last character of a line is a continuation indicator

#fix: deal with no author issue, e.g., call it Editorial staff
#fix: may not need trailing | any more -- may never have

#formats
#issue|year|number|publicationdate|published
             #where the last two fields are optional; the fifth
             #field indicates the issue status:  blank (meaning the issue is still in
             #draft format) or "published"; the previous field gives the publication date
             #in the format 2005-01-15
#category|category where category is Announcements, Articles, or Columns
#piece|title1|author|directory|title2|title3 where
             #title1 is in html display format, title2 is for sorting,
             #and title3 is for bibtex entries; title2 and title3 are optional

issue|2005|2|2005-4-15|

category|Announcements
piece|From the Editor|Lance Carnes|carnes|

category|Articles
piece|paper name|author name|directoryname

category|Columns
piece|<tt>\begin{here} % getting started</tt>|Douglas Waud|waud|begin{here} % getting started|\
      \texttt{\char`\\begin\{here\} \% getting started}
piece|<tt>\starttext % Practical ConTeXt</tt>|Steve Peter|peter|starttext: Practical ConTeXt|\
      \texttt{\char`\\starttext \% Practical ConTeXt}
piece|Travels in TeX Land:  Tweaking LaTeX|David Walden|walden|
piece|Ask Nelly: What is ...?; |The Editors|asknelly|
piece|In my opinion|Peter Flynn|flynn|