% vim:foldmethod=marker foldmarker=--->,<---

\section{Appendix}

\label{SecAppendix}


\subsection{Search command syntax}

\label{SecSearchCommand}

  \index{search!syntax of search command file}
Search in a \texttt{References} can directed to ``database fields'' with field
labels (table \ref{tab:FieldLabels}). The command \mopt{main-s} searches for a
condition, in most cases, a substring contained in the text of that field.
The general syntax for a search command is:

{ \small
\begin{verbatim}
   FLBL=condition [|condition [|...]] & FLBL [|condition [|...]] & [&...]
\end{verbatim}
}

%% Table-search commands ---> 

\begin{table}[h]
  \centering
  \begin{tabular}{l p{14cm}} \hline

   \textbf{Label} & \textbf{Description} \\ \hline
   \texttt{auth} & 
   autor(s) of an article in a journal/periodial (j1), of an article/chapter
   in a book (b2) \\
   
   \texttt{inau} & 
   institutional autor(s) (j2, m2)\\

   \texttt{edit} & 
   Editor(s)/author(s) of a book \\

   \texttt{edtn} &
   edition number of a book (b1, b2, b3) \\

   \texttt{idnr} &
   identification numbers\\
   
   \texttt{ined} & 
   institutional editor(s) of book (b3) \\

   \texttt{dtyp} & 
   Document type, supported in current version: j1, j2, b1, b2, b3, m1, m2 \\

   \texttt{jrnl} & 
   journal name (journal code/key) \\

   \texttt{keyw} & 
   keywords \\

   \texttt{plac} & 
   place of publication \\

   \texttt{publ} & 
   publisher (of a book)\\

   \texttt{stat} & 
   status field \\

   \texttt{tita} & 
   title of an article in a periodical in a journal/periodical of a chapter in
   a book \\

   \texttt{titb} & 
   title of a book \\

   \texttt{volj} &
   volume of a journal (j1, j2) \\

   \texttt{year} & 
   year of the date of publication \\ \hline

  \end{tabular}
  \caption[Search commands: field labels]{Field labels for search commands. 
    Use of field labels is case insensitive}
  \label{tab:FieldLabels}
\end{table}
%% <---

A search command may comprise more than one condition linked with `\&'
(logical or `boolean' AND). Each `\&'-clause may contain one or more text
fragments to be searched for separated by `\textbar' (`\textbar' is
interpreted in search commands as logical or `boolean' OR). Each `\&'-clause
is introduced by a field label (FLBL) which restricts the search to a database
field (e.g title, keywords, date of publication).  The field label is followed
by a `=' and the string(s separated by `\textbar's) to be searched for.

A simple example for a search command is:

\begin{verbatim}
   keyw=anemia
\end{verbatim}

it means: ``find all records with the keywords \emph{anemia}'', leading and
trailing spaces are automatically removed, this format is also valid:

\begin{verbatim}
   keyw = anemia
\end{verbatim}

The command

\begin{verbatim}
   keyw = anemia & dtyp = j1
\end{verbatim}

means: ``find all references with `anemia' in the keywords field, but only
those which are of the article in a journal (j1) type.'' 

\begin{verbatim}
   keyw = anemia | red cell | platelets & dtyp = j1
\end{verbatim}

means: ``find journal articles (j1) with `anemia' or `red cell' or `platelets' in
the keywords field''

{\small
\begin{verbatim}
   keyw = anemia | red cell | platelets & dtyp = j1 & year = 1980 - 1994
\end{verbatim}
}

means: ``find all journal articles with `anemia' or `red cell' or `platelets' in
the keywords field, which appeared in the time between 1980 and 1994''.


\begin{verbatim}
   auth=Mueller | Keller | Mayer | Guenter & keyw = platelets & 
   dtyp=j1 | b2 & year=1973 | 1980-1994 |1996 | 1998
   &tita=platelet |rbc | granuloc | neutrophil & tita=review
\end{verbatim}

This command should be written in one line, it means: ``find all journal
articles and all book chapters with the keyword `platelets', with authors
`Mueller', `Keller', `Mayer' or `Guenter', which appeared in 1973 or between
1980 and 1994 or in 1996 or 1998. In the title of the article the text
fragments `platelet' or `rbc' or `granuloc' or `neutrophil' must appear, the
title must contain the string `review'.'' This is not a typical example, but
illustrates that complex search operations may be performed on a
\texttt{References} database.

Some special cases have to be regarded with certain field labels: normally,
\texttt{References} `finds' a record, if the substring entered in the
search-command is found in the pertinent field of the database. For example:

\begin{verbatim}
   KEYW = antib
\end{verbatim}

finds the references with the keywords `alloantiodies',
`anti-phospholipid-antibodies' or `antibody-induced phagocytosis'. In some
fields, there are exceptions:
\begin{enumerate}
\item Field labels `\texttt{JRNL}', `\texttt{EDTN}' and `\texttt{VOLJ}': 
  here \texttt{References} searches for \emph{identity} of the string in the search
  command and the contents of the `Journal'-field:
\begin{verbatim}
   jrnl=n
\end{verbatim}
  only finds `n', but not `nejm'. 
  
\item Field label `\texttt{YEAR}': 
  \texttt{References} translates the text in the `year'-field into a number
  and tries to `understand' ranges of years:
\begin{verbatim}
   year = 1990-1992
\end{verbatim}
   is equivalent to
\begin{verbatim}
   year = 1990 | 1991 | 1992
\end{verbatim}
   the first format (1990-1992) however, will be processed faster.
   
\item Field labels `\texttt{AUTH}', `\texttt{EDIT}': searches only for the
   name, initials are ignored.
\end{enumerate}

If you apply search-commands on large databases, the time required for their
execution will be influenced by the sequence in which the `\&'-clauses appear.
The following rule applies: You should insert those conditions, which reduce
the size of the resulting bbt-file most, as the first `\&'-clauses into the
search command.

If you do not wish to search the complete database, you may restrict a
search operation to a set of references defined in a bbt-file (select command
\texttt{b} instead of \texttt{c}) after starting search.

\clearpage

\subsection{Bibliographic format definitions}

\subsubsection{Bibliographic format definition form}

\label{sec:BibliographicFormatDefForm}

{ \footnotesize
% \listinginput[5]{1}{leer.fde}
\verbatiminput{leer.tex}
}

\clearpage

\subsubsection{Keywords of bibliographic format definitions}

\label{DescriptionOfKeywords}

%% table - list of keywords --->

\begin{longtable}{|l|p{13.5cm}|} \hline
\textbf{keyword} & \textbf{description}\\
\hline \hline  \endhead 
\multicolumn{2}{|c|}{\emph{sequence of major elements (lines)}}\\ \hline
\texttt{\%au}
& indicates the position of the authors' names line
  (in the \texttt{major elements (lines) for document type ...} fields at the
  beginning of the format definition)  \\ 
\texttt{\%ed} &
  editors of a book (or authors of a complete book) \\
\texttt{\%ti} &
  title of article \\
\texttt{\%bo} &
  book title \\
\texttt{\%lo} &
  `localization' data: journal name, volume, range of pages, publisher, place
  of publication \\
\hline
\multicolumn{2}{|c|}{\emph{keywords for the remaining fields}}\\ \hline
\texttt{\%()} &
  inserts the delimiters (strings) of the argument in brackets into 
  lists of authors or editors (only in the \texttt{list of authors/editors 
  lines (j1, b1, b2)}-fields  for delimiters)
  \\ \hline

\texttt{\%Auflage} &
  inserts the German word ``Auflage'' (edition [e.\,g. of a book]) if the field for the edition
  number is not empty \\ \hline

\texttt{\%auth} &
  controls position of authors' [personal or institutional] names 
  (of article in journal, article/chapter in a book) \\
  \hline 

\texttt{\%day} &
  inserts day number (of date of publication) \\ \hline

\texttt{\%d()} &
  inserts the argument in brackets, if the field for `day' is not empty \\
  \hline

\texttt{\%e()} &
  inserts the argument in brackets, if the field for edition number is not
  empty \\ \hline

\texttt{\%ededs} &
  inserts the word `editor', if the number of authors/editors is one,
  otherwise inserts `editors' \\ \hline

\texttt{\%Ededs} &
  inserts the word `Editor', if the number of authors/editors is one,
  otherwise inserts `Editors' \\ \hline

\texttt{\%edition} &
  inserts the text string `\texttt{. edition}', if the field for the edition
  number is not empty \\ \hline

\texttt{\%Edition} &
  inserts the text string `\texttt{. Edition}', if the field for the edition
  number is not empty \\ \hline

\texttt{\%edits} &
  indicates position of editors'/authors' [personal or institutional] 
  names (of book) \\ \hline

\texttt{\%edno} &
  inserts edition number of a book, if this field is not empty \\ \hline

\texttt{\%endline} &
  inserts the end-of-line code (character) \\ \hline

\texttt{\%fullstop} &
  inserts the `.' character, if the previous character is \emph{not} one of
  the following: \texttt{.,?!;} \\ \hline

\texttt{\%howpub} &
  inserts the contents of the howpublished-field \\ \hline

\texttt{\%hp()} &
  inserts the argument in brackets, if the howpublished-field is not empty \\ \hline

\texttt{\%i[]()} &
  inserts the argument in (round) brackets if the identifying number of the
  type in square brackets exists in the identifying numbers field.
  Example: \texttt{\%i[url](, )} inserts a comma and a space if a number of
  the type ``\verb+url:http//www...+'' 
  exists in the \texttt{IDNR} (identifying numbers) field\\  \hline

\texttt{\%ibn()} &
  inserts the argument in brackets, if the ISBN-field is not empty \\ \hline

\texttt{\%id[]} &
  inserts the identifying number of the type in square brackets (if it exists)
  from the \texttt{IDNR} (identifying numbers) field. Example: 
  \texttt{\%id[doi]} inserts \texttt{10.1111/j.1365-3148.2005.00578.x}, if 
  \texttt{References} finds  
  \texttt{doi:10.1111/j.1365-3148.2005.00578.x}
  in the \texttt{IDNR} (identifying numbers) field  \\  \hline

\texttt{\%idn()} &
  inserts the argument in (round) brackets if the \texttt{IDNR} (identifying
  numbers) field is not empty\\ \hline

\texttt{\%idnr} &
  inserts the contents of the \texttt{IDNR} (identifying numbers) field \\
  \hline

\texttt{\%ina()} &
  inserts the argument in brackets if the `institutional author' field is not 
  empty \\ \hline

\texttt{\%ine()} &
  inserts the argument in brackets if the `institutional editor' field is not 
  empty \\ \hline


\texttt{\%inu()} &
  inserts the argument in brackets if the `issue number' field is not empty
  \\ \hline

\texttt{\%isbn} &
  international standard book number (ISBN)
  \\ \hline
\texttt{\%isn()} &
  inserts the argument in brackets, if the ISSN-field is not empty
  \\ \hline

\texttt{\%issn} &
  inserts  the international serial standard number (ISSN)
  \\ \hline

\texttt{\%issuenum} &
  issue number (of a periodical or journal)
  \\ \hline

\texttt{\%journ} &
  inserts the full journal name
  \\ \hline

\texttt{\%journkey} &
  inserts the ``raw''
  journal code (the `key' for journal records in the database file
  for journal data) is directly inserted 
  \\ \hline

\texttt{\%journsh} &
  inserts the short form (abbreviated form) of the journal name, if the
  abbreviated form is available in the journal names database, otherwise the
  full name is entered
  \\ \hline

\texttt{\%journ4l} &
  synonym for \texttt{\%journkey} (obsolete) 
  \\ \hline

\texttt{\%js()} &
  inserts the short (abbreviated form) of the journal name, if
  the field for the abbreviated name is not empty in the database, otherwise
  the program enters the full name. The argument in brackets is inserted
  between the elements of the abbreviated form.  Examples: \texttt{\%js(. )}
  with the abbreviated journal name \texttt{Brit J Haematol} inserts
  \texttt{Brit. J. Haematol} into the localization line; \texttt{\%js(-)}:
  \texttt{Brit-J-Haematol}
  \\ \hline

\texttt{\%kwds} &
  inserts the list of keywords
  \\ \hline

\texttt{\%m()} &
  inserts the argument in brackets if the field for `month' is not empty
  \\ \hline

\texttt{\%month} &
  inserts the month number (of date of publication)
  \\ \hline

\texttt{\%n} &
  inserts the number of a reference in a list of references 
  \\ \hline

\texttt{\%p()} &
  inserts the argument in
  brackets, if at least first page (or first and last pages) field(s) is/are
  not empty
  \\ \hline

\texttt{\%pagefrom} &
  inserts the `page from' (first page of a range of  pages)
  \\ \hline

\texttt{\%pageto} &
  inserts the `page to' (last page of a range of  pages)
  \\ \hline

\texttt{\%pagetosh} &
  inserts significant last figures of `last page' (page to)
  \\ \hline

\texttt{\%pgs()} &
  places the argument in brackets between first and last page of a range of
  pages 
  \\ \hline

\texttt{\%place} &
  inserts the place of publication, in case of a comma-separated list in the
  \texttt{\%place}-field, selects only the first town-name
  \\ \hline

\texttt{\%places} &
  inserts all places of publication
  \\ \hline

\texttt{\%publisher} &
  inserts the name of the publisher, publishing company
  \\ \hline

\texttt{\%refnr} &
  inserts the reference number key
  \\ \hline

\texttt{\%space} &
  enters a space character 
  \\ \hline

\texttt{\%status} &
  inserts the contents of the status field
 \\ \hline

\texttt{\%title} &
  inserts title of an article in a journal or title of a chapter/an article in
  a book
  \\ \hline

\texttt{\%tab} &
  inserts a tab character ($\rightarrow$) 
  \\ \hline

\texttt{\%titlebo} &
  inserts the book title 
  \\ \hline

\texttt{\%v()} &
  inserts the argument in brackets, if the volume field is not empty
  \\ \hline

\texttt{\%volume} &
  inserts volume of a periodical, of a journal 
  \\ \hline


\texttt{\%year} &
  inserts the year (of the date of publication)
  \\ \hline

\end{longtable}
%% <---

\subsubsection{Which keywords in which fields?}

% Muß wieder weg:
% \verb+%i[]()+,
% \verb+%id[]+,
% \verb+%idn()+,
% \verb+%idnr+,



\label{secKeywdsInFields}

\texttt{References} recognizes keywords only if they appear in the appropriate
fields. As an example, \texttt{\%auth} will not insert the list of authors
into the ``book title line'', it will be inserted here literally. The
following paragraphs list keywords recognized in format definition
fields.

%% list keywords and their context in fd files --->

\paragraph{Major elements (lines) for document type `journal article' (j1)}
\verb+%au+, 
\verb+%ti+, 
\verb+%so+.

\paragraph{Major elements (lines) for document type `journal article
with institutional author' (j2)}
\verb+%au+, 
\verb+%ti+, 
\verb+%so+.


\paragraph{Major elements (lines) for document type `book' (b1)}
\verb+%ed+, 
\verb+%bo+, 
\verb+%lo+.


\paragraph{Major elements (lines) for document type `chapter/article in a
  book' (b2)}
\verb+%au+,
\verb+%ed+,
\verb+%ti+,
\verb+%bo+,
\verb+%lo+.

\paragraph{Major elements (lines) for document type `book with institutional
editor' (b3)}
\verb+%ed+, 
\verb+%bo+, 
\verb+%lo+.


\paragraph{Major elements (lines) for document type `miscellanea' (m1)}
\verb+%au+, 
\verb+%ti+, 
\verb+%so+.

\paragraph{Major elements (lines) for document type `miscellanea with
institutional author' (m2)}
\verb+%au+, 
\verb+%ti+, 
\verb+%so+.


\paragraph{List of authors line (journal article) [j1]}
\verb+%auth+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+.



\paragraph{Title line (journal article) [j1]}
\label{rfdky:j1title}
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%refnr+,
\verb+%n+,
\verb+%tab+,
\verb+%title+,
\verb+%year+,
\verb+%space+.


\paragraph{Localization line (journal article) [j1]}

\verb+%d()+,
\verb+%day+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%inu()+,
\verb+%isn()+,
\verb+%issn+,
\verb+%issuenum+,
\verb+%journ+,
\verb+%journ4l+,
\verb+%journsh+,
\verb+%js()+,
\verb+%kwds+,
\verb+%m()+,
\verb+%month+,
\verb+%p()+,
\verb+%pagefrom+,
\verb+%pageto+,
\verb+%pagetosh+,
\verb+%pgs()+,
\verb+%space+,
\verb+%status+,
\verb+%tab+,
\verb+%v()+,
\verb+%volume+,
\verb+%year+.


\paragraph{Author line (journal article with institutional
author) [j2]}
\verb+%auth+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%ina()+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+.



\paragraph{Title line (journal article with institutional author)
[j2]}
\label{rfdky:j2title}
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+.
\verb+%tab+,
\verb+%title+,
\verb+%year+,


\paragraph{Localization line (journal article with institutional
author) [j2]}


\verb+%d()+,
\verb+%day+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%inu()+,
\verb+%isn()+,
\verb+%issn+,
\verb+%issuenum+,
\verb+%journ+,
\verb+%journ4l+,
\verb+%journsh+,
\verb+%js()+,
\verb+%kwds+,
\verb+%m()+,
\verb+%month+,
\verb+%p()+,
\verb+%pagefrom+,
\verb+%pageto+,
\verb+%pagetosh+,
\verb+%pgs()+,
\verb+%space+,
\verb+%status+,
\verb+%tab+,
\verb+%v()+,
\verb+%volume+,
\verb+%year+.



\paragraph{List of editors line (book) [b1]}

\verb+%Ededs+,
\verb+%ededs+,
\verb+%edits+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+



\paragraph{Title line (book) [b1]}

\verb+%Auflage+,
\verb+%Edition+,
\verb+%e()+,
\verb+%edition+,
\verb+%edno+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%titlebo+,
\verb+%year+.



\paragraph{Localization line (book) [b1]}

\verb+%Auflage+;
\verb+%Edition+;
\verb+%e()+;
\verb+%edition+;
\verb+%edno+;
\verb+%endline+;
\verb+%fullstop+;
\verb+%i[]()+,
\verb+%ibn()+;
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%isbn+;
\verb+%kwds+;
\verb+%p()+;
\verb+%pagefrom+;
\verb+%pageto+;
\verb+%pagetosh+;
\verb+%place+;
\verb+%places+;
\verb+%publisher+;
\verb+%space+;
\verb+%status+;
\verb+%tab+,
\verb+%year+.



\paragraph{List of authors line (chapter/article in a book) [b2]}


\verb+%auth+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+.




\paragraph{Title line (chapter/article in a book) [b2]}

\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+.
\verb+%tab+,
\verb+%title+,
\verb+%year+,


\paragraph{List of editors line (chapter/article in a book) [b2]}

\verb+%Ededs+,
\verb+%ededs+,
\verb+%edits+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+.



\paragraph{Book title line (chapter/article in a book) [b2]}


\verb+%Auflage+,
\verb+%Edition+,
\verb+%e+,
\verb+%edition+,
\verb+%edno+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%titlebo+,
\verb+%year+.


\paragraph{Localization line (chapter/article in a book) [b2]}

\verb+%p()+,
\verb+%Auflage+,
\verb+%e()+,
\verb+%edition+,
\verb+%Edition+,
\verb+%edno+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%ibn()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%isbn+,
\verb+%kwds+,
\verb+%pagefrom+,
\verb+%pageto+,
\verb+%pagetosh+,
\verb+%pgs+,
\verb+%place+,
\verb+%places+,
\verb+%publisher+,
\verb+%space+,
\verb+%status+,
\verb+%tab+,
\verb+%year+.


\paragraph{List of editors line (book with institutional editor)
[b3]}

\verb+%Ededs+,
\verb+%ededs+,
\verb+%edits+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%ine()+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+.



\paragraph{Title line (book with institutional editor) [b3]}

\verb+%Auflage+,
\verb+%e()+,
\verb+%edno+,
\verb+%edition+,
\verb+%Edition+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%refnr+,
\verb+%n+,
\verb+%space+,
\verb+%tab+,
\verb+%titlebo+,
\verb+%year+.



\paragraph{Localization line (book with institutional editor) [b3]}

\verb+%Auflage+,
\verb+%Edition+,
\verb+%e()+,
\verb+%edition+,
\verb+%edno+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%i[]()+,
\verb+%ibn()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%isbn+,
\verb+%kwds+,
\verb+%p()+,
\verb+%p()+,
\verb+%pagefrom+,
\verb+%pageto+,
\verb+%pagetosh+,
\verb+%place+,
\verb+%places+,
\verb+%publisher+,
\verb+%space+,
\verb+%status+,
\verb+%tab+,
\verb+%year+.




\paragraph{List of authors line (miscellanea) [m1]}
\verb+%auth+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%howpub+,
\verb+%hp()+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+.



\paragraph{Title line (miscellanea) [m1]}
\label{rfdky:m1title}
\verb+%endline+,
\verb+%fullstop+,
\verb+%howpub+,
\verb+%hp()+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%n+,
\verb+%refnr+,
\verb+%space+.
\verb+%tab+,
\verb+%title+,
\verb+%year+,


\paragraph{Localization line (miscellanea) [m1]}


\verb+%d()+,
\verb+%day+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%howpub+,
\verb+%hp()+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%kwds+,
\verb+%m()+,
\verb+%month+,
\verb+%p()+,
\verb+%pagefrom+,
\verb+%pageto+,
\verb+%pagetosh+,
\verb+%pgs()+,
\verb+%space+,
\verb+%status+,
\verb+%tab+,
\verb+%year+.



\paragraph{List of authors line (miscellanea with institutional
author) [m2]}
\verb+%auth+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%howpub+,
\verb+%hp()+
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%ina()+
\verb+%n+,
\verb+%refnr+,
\verb+%space+,
\verb+%tab+,
\verb+%year+.



\paragraph{Title line (miscellanea with institutional author) [m2]}
\label{rfdky:m2title}

\verb+%endline+,
\verb+%fullstop+,
\verb+%howpub+,
\verb+%hp()+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%refnr+,
\verb+%n+,
\verb+%title+,
\verb+%year+,
\verb+%space+,
\verb+%tab+.


\paragraph{Localization line (miscellanea with institutional
author) [m2]}


\verb+%d()+,
\verb+%day+,
\verb+%endline+,
\verb+%fullstop+,
\verb+%howpub+,
\verb+%hp()+,
\verb+%i[]()+,
\verb+%id[]+,
\verb+%idn()+,
\verb+%idnr+,
\verb+%kwds+,
\verb+%m()+,
\verb+%month+,
\verb+%p()+,
\verb+%pagefrom+,
\verb+%pageto+,
\verb+%pagetosh+,
\verb+%pgs()+,
\verb+%space+,
\verb+%status+,
\verb+%tab+,
\verb+%year+.

%% <---

\subsection{Structure of archive files}

\label{sec:ArchiveFilesDescript}


Archive files contain the contents of a \texttt{References} database in text
file format. Archive files allow to

\begin{itemize}
\item transfer (parts of) a database into another \texttt{References}
  installation 
\item transfer the complete databases into database of a recent (higher)
  \texttt{References} version 
\item make a backup of \texttt{References} databases
\end{itemize}

Each archive file contains three major sections: 

\begin{enumerate}
  \item bibliographic references are stored in the section introduced by
  \texttt{BEGIN REFERENCES}. 
  \item journal names and their abbreviated forms are
  introduced by \texttt{BEGIN JOURNALS}. 
  \item the keywords thesaurus is headed by \texttt{BEGIN KEYWORDS THESAURUS}.
\end{enumerate}

The labels (four letters) at the beginning of each line (table
\ref{ArchiveFilesFNames}) correspond to fields in the database.

%% table - list of field labels in archive files --->

\begin{table}[h]
  \begin{center}
\begin{tabular}{ll} \hline
\textbf{Field label} & \textbf{description} \\ \hline
\texttt{ABST} & abstract \\
\texttt{AUTH} & list of authors of a journal or a book-chapter \\
\texttt{DAYP} & date of publication: day \\
\texttt{DTYP} & document type (j1, j2, b1, b2 or b3) \\
\texttt{EDIT} & list of editors of a book \\
\texttt{EDTN} & edition number \\
\texttt{HOWP} & howpublished \\
\texttt{IDNR} & identification numbers \\
\texttt{INAU} & institutional author \\
\texttt{INED} & institutional editor \\
\texttt{ISBN} & international standard book number \\
\texttt{ISNU} & issue number \\
\texttt{JRNL} & journal code (index) \\
\texttt{KEYW} & keywords field of a bibliographic record\\
\texttt{MONP} & date of publication: month \\
\texttt{PGFR} & ``page from'': first page of an article, of a chapter\\
\texttt{PGTO} & ``page to'': last page of an article, of a chapter\\
\texttt{PLAC} & place of publication (of a book) \\
\texttt{PUBL} & publisher (\textit{Herausgeber}, \textit{\'Editeur})\\
\texttt{RECN} & record number, reference number \\
\texttt{STAT} & status field \\
\texttt{TITA} & title of an article in a book\\
\texttt{TITB} & title of a book\\
\texttt{VOLM} & volume \\
\texttt{YEAR} & date of publication: year \\[1ex]

\texttt{ISSN} & international standard serial number \\
\texttt{JCOD} & journal code \\
\texttt{JNAM} & journal name \\
\texttt{JS01} & short form (variant 1) of journal name\\[1ex]

\texttt{KEYT} & item in keywords thesaurus \\
% b1 `abgearbeitet'

\hline
\end{tabular}
\end{center}
\caption{Field labels in archive files}
\label{ArchiveFilesFNames}
\end{table}

%% <---


\begin{listing}[5]{1}
****:BEGIN ARCHIVE

****:BEGIN REFERENCES

RECN:i05747
DTYP:b1
EDIT:Colman,RW;Hirsh,J;Marder,VJ;Clowes,AW;George,JN
TITB:Hemostasis and thrombosis. Basic principles and clinical practice
EDTN:4
ISBN:0-7817-1455-9
PLAC:Philadelphia
IDNR:
YEAR:2001
PUBL:Lippincott Williams and Wilkins
PGFR:
PGTO:
STAT:y
KEYW:hemostasis, hemostatic disorders, thrombosis, textbook
ABST:

RECN:i05840
DTYP:b2
AUTH:Sebring,ES
TITA:Fetomaternal hemorrhage -- incidence and methods of detection ...
EDIT:Garratty,G
TITB:Hemolytic diasease of the newborn
EDTN:
ISBN:0-915355-05-1
PLAC:Arlington
IDNR:
YEAR:1984
PUBL:American Association of Blood Banks
PGFR:87
PGTO:117
STAT:y
KEYW:hemolytic disease of the newborn, fetomaternal hemorrhage, ...
ABST:

RECN:i05862
DTYP:j1
AUTH:Gombotz,H;Schatz,E
TITA:Tolerance of perisurgical anaemia
JRNL:it
IDNR:
YEAR:2002
MONP:6
DAYP:
VOLM:29
ISNU:3
PGFR:163
PGTO:166
STAT:y
KEYW:anemia, surgery, transfusion trigger, blood loss, rbc transfusion
ABST:

****:END REFERENCES

****:BEGIN JOURNALS

JCOD:aa
ISSN:
JNAM:Anesthesia and Analgesia
JS01:Anesth Analg

JCOD:aas
ISSN:
JNAM:Acta Anaesthesiologica Scandinavica
JS01:Acta Anaesthesiol Scand

JCOD:ab
ISSN:
JNAM:Analytical Biochemistry
JS01:Anal Biochem

JCOD:ach
ISSN:0001-5792
JNAM:Acta Haematologica
JS01:Acta Haematol

...

JCOD:zif
ISSN:
JNAM:Zeitschrift fuer Immunitaetsforschung
JS01:

****:END JOURNALS

****:BEGIN KEYWORDS THESAURUS

KEYT:(111)In

KEYT:(14)C serotonin release assay

KEYT:(51)Cr

KEYT:12F1

...

KEYT:zalcitabine

KEYT:zidovudine, (AZT)

****:END KEYWORDS THESAURUS

****:END ARCHIVE
\end{listing}

\clearpage

\subsection{Format of Bib\TeX\ database files}

\label{sec:BibTeXDBFormat}

{ \footnotesize
\begin{verbatim}
@incollection{000001,
  editor = {Colman, R. W. and Hirsh, J. and Marder, V. J. and Clowes, A. W. and George, J. N.},
  author = {Kunicki, T. J.},
  booktitle = {{Hemostasis and thrombosis. Basic principles and clinical practice}},
  title = {{Platelet immunology}},
  edition = {4},
  address = {Philadelphia, Baltimore, New York, London, Buenos Aires, Hong Kong, Sydney, Tokyo},
  publisher = {Lippincott Williams and Wilkins},
  pages = {461--477},
  year = {2001}
}


@book{000007,
  editor = {Colman, R. W. and Hirsh, J. and Marder, V. J. and Clowes, A. W. and George, J. N.},
  title = {{Hemostasis and thrombosis. Basic principles and clinical practice}},
  edition = {4},
  address = {Philadelphia},
  publisher = {Lippincott Williams and Wilkins},
  year = {2001}
}


@article{000002,
  author = {Peters, A. M. and Klonizakis, I. and Lavender, J. P. and Lewis, S. M.},
  title = {{Use (111)indium-labelled platelets to measure spleen function}},
  journal = {British Journal of Haematology},
  year = {1980},
  volume = {46},
  pages = {587--593}
}


@misc{000008,
  author = {Ihaka, R. and Gentleman, R.},
  title = {{R statistical software version 1.6.2}},
  howpublished = {Comprehensive R Archive Network. URL http://cran.at.r-project.org},
  year = {2003}
}


\end{verbatim}
\par}

\subsection{Names of AWK scripts called by the ``process text files'' menu
options }
\label{secAWKScripts}

Options of the menu \mopt{edit-main-p} mainly call AWK scripts. Names of the
corresponding scripts are listed in table
\ref{tabAWKScripts}. All \texttt{AWK} scripts are located in the
\texttt{bin}-subdirectory. In addition to the scripts in table~\ref{tabAWKScripts} \texttt{fromcite.awk} and \texttt{tocite.awk} have been
added to this directory. A short description is included in the commented
section of these files\footnote{The files may be used as filters and are able
to convert \texttt{refscite()} to \LaTeX s \texttt{cite} commands and \emph{vice versa}}.

\begin{table}[h]
\centering
\begin{tabular}{llp{0.53\textwidth}}
{\large \textbf{Menu option}} &
  {\large \textbf{Name of script}} &
    {\large \textbf{Description}} \\[1.4ex] 
\mopt{edit-main-p htm} &
  \verb+txt2html.awk+ &
    Converts lists of references/text files into HTML files \\[1.3ex] 
\mopt{edit-main-p ltx} &
  \texttt{txt2ltx.awk} &
    Converts lists of references/text files into \LaTeX files \\[1.3ex] 
\mopt{edit-main-p exc} &
  \texttt{excite.awk} &
    extracts reference numbers from \verb+\cite{}+ commands in
    \LaTeX-documents\\[1.3ex] 
\mopt{edit-main-p xex} &
  \texttt{xexcite.awk} &
    Extended \texttt{excite.awk}: reference numbers from 
    \verb+\cite{}+
    and related commands in
    \LaTeX-documents \\[1.3ex] 
\mopt{edit-main-p srt} &
  \texttt{sortrefs.awk} &
    Creates macro for sorting \\[1.3ex] 
\mopt{edit-main-p wdm} &
  \verb+msw_sr.awk+ &
    Creates MS Word macro for converting bibliographic citations in a
    manuscript \\[1.3ex] 
\mopt{edit-main-p osw} &
  \verb+ooo_sr.awk+ &
    Creates OpenOffice/StarOffice Writer macro for 
    converting bibliographic citations in a
    manuscript \\[1.3ex] 
\mopt{edit-main-p vi} &
  \verb+vi_sr.awk+ &
    Creates Vi/Vim text editor macro for 
    converting bibliographic citations in a
    manuscript \\[1.3ex] 
\mopt{edit-main-p msr} &
  \verb+man_srl.awk+ &
    Creates a search and replace list for manual
    change of raw bibliographic citations into formatted
    citations in a text processor \\[1.3ex] 
\mopt{edit-main-p rsr} &
  \verb+refs_sr.awk+ &
    Creates a \texttt{References} search and replace script for
    formatting bibliographic citations\\[1.3ex]
\mopt{edit-main-p exa} &
  \verb+ex_arr.awk+ &
    Extracts reference numbers from an arr-file \\[1.3ex]

\mopt{edit-main-p snc} &
  \verb+group-num-cit.awk+ &
    Converts list of numeric citations in a manuscript
    into a sorted, compressed list \\[1.3ex]
(no menu option) &
\verb+fromcite.awk+ &
    changes \verb+\cite{}+s into \texttt{refscite()}s in 
    the manuscript\\[1.3ex]
(no menu option) &
\verb+tocite.awk+ &
    changes  \texttt{refscite()}s into \verb+\cite{}+s 
    in the manuscript\\[1.3ex]
\end{tabular}

  \caption{AWK-scripts and corresponding commands in \texttt{References}}
  \label{tabAWKScripts}
\end{table}


\clearpage

%%% Local Variables: ***
%%% mode:latex ***
%%% TeX-master: "refsdok.tex"  ***
%%% End: ***
