\documentstyle[german,12pt,makeidx]{script}
\input{briefini.tex}
\makeindex
\parindent0em
\parskip2ex
\begin{document}

%  \batchmode
  \title{Dokumentation zu Brief.STY}
  \author{Gundolf Frank\footnotemark}
  \footnotetext[1]{\begin{tabular}[t]{ll}
                      Tel.:  &++49 (0)241/532520\\
                      E-Mail:&Gundolf\_Frank@AC.maus.de
                    \end{tabular}}
  \maketitle

  \tableofcontents

  \chapter{Einf�hrung}

  Der Brief-Style ist eine Mischung aus dem orginal Letter-Style von Leslie 
  Lamport, den Erweiterungen von Helmut Kopka aus \cite{Kopka}. Da ich immer 
  noch einige Sachen vermi�te, habe ich diese erweitert. Am meisten st�rte 
  mich, da� der "`Luxus"' einer Adressverwaltung mit Serienbrieffunktion unter 
  \TeX\ noch nicht verwirklicht worden ist. Dies konnte doch jedes andere 
  popelige Textverarbeitungsprogramm\footnote{Ich wei�, da� \TeX\ keine 
  Textverarbeitung ist, sondern ein Textsatzsystem; trotzdem wird es von 
  vielen -auch von mir- als Ersatztextverarbeitung benutzt.}, also hatte ich 
  mir eingebildet, da� \TeX dies auch k�nnen mu�te. Und so ist dann dieser 
  Style entstanden.\par
 
  Da es viele geben wird, die zwar die Serienbrief- und Adressbuchfunktion 
  m�gen, aber die ganzen anderen Funktionen nicht m�gen, habe ich die 
  Serienbrieffunktion noch in einen eigenen Style eingepackt. Dieser hei�t 
  "`Serienbr.STY"'.\par

  Nun viel Spa� beim Briefeschreiben -mit oder ohne meinen Brief-Style!\par

  Gundolf Frank

  \chapter{Allgemeine {\em Variablen} und {\bf Befehle}}

  \section{{\bf $\backslash$begin\{letter\}}}
  {\bf Syntax:} $\backslash$begin\{letter\}[Suchkriterum]\{Adressat\}\par

  Markiert den Beginn eines Briefes an {\em Adressat\/} und beginnt eine
  neue Seite

  \section{{\bf $\backslash$end\{letter\}}}
  {\bf Syntax:} $\backslash$end\{letter\}\par

  Markiert das Ende eines Briefes

  \section{{\bf $\backslash$opening} oder {\bf $\backslash$anrede}}

  {\bf Syntax:} $\backslash$opening[Abk�rzungen]\{Name\}\\
  {\bf Syntax:} $\backslash$anrede[Abk�rzungen]\{Name\}\par
  Die beiden Befehle "`$\backslash$anrede"` oder "`$\backslash$opening"' haben
  die selbe Funktion. Sie setzen die Anrede �ber dem Brief.\\
  Im Namen kann entweder der ganze Text stehen, wenn keine Abk�rzung
  angegeben ist, oder nur der Vor- oder Nachname.\\
  Wenn keine Abk�rzung angegeben ist, k�nnen die eckigen Klammern wegfallen.\par
  Folgende Abk�rzungen stehen zur Auswahl:\\
  \begin{tabular}{lll}
         &Anrede                            &und dazugeh�rige Gru�formel\\
    sgdh &Sehr geehrte Damen und Herren,    &Mit freundlichen Gr��en\\
    l    &Liebe {\em "`Name"'},             &Mit $\heartsuit$-lichen Gr��en\\
    lr   &Lieber {\em "`Name"'},            &Mit $\heartsuit$-lichen Gr��en\\
    ls   &Liebes {\em "`Name"'},            &Mit $\heartsuit$-lichen Gr��en\\
    sgh  &Sehr geehrter Herr {\em "`Name"'},&Mit freundlichen Gr��en\\
    sgf  &Sehr geehrte Frau {\em "`Name"'}, &Mit freundlichen Gr��en\\
    sgH  &Sehr geehrte Herren,              &Mit freundlichen Gr��en\\
    sgF  &Sehr geehrte Damen,               &Mit freundlichen Gr��en\\
    sgs  &Sehr geehrtes {\em "`Name"'},     &Mit freundlichen Gr��en\\
    {\em leer} &{\em "`Name"'}              &Mit freundlichen Gr��en
  \end{tabular}\par
  In Zusammenarbeit mit dem Adressbuch werden die Anrede entsprechend dem 
  Geschlecht und dem Kontakt gesetzt:\\
  \begin{tabular}{cll}
    Geschlecht & Kontakt    & Anrede \\
       w       & herzlich   & Liebe {\em "`Name"'},\\
               & formal     & Sehr geehrte Frau {\em "`Name"'},\\
       m       & herzlich   & Lieber {\em "`Name"'},\\
               & formal     & Sehr geehrte Frau {\em "`Name"'},\\
       n       &            & Sehr geehrte Damen und Herren,\\
  \end{tabular}

  \section{{\bf $\backslash$closing} oder {\bf $\backslash$gruss}}

  \label{Gruss}

  {\bf Syntax:} $\backslash$closing\{Text\}\\
  {\bf Syntax:} $\backslash$gruss\{Text\}\par

  Die beiden Befehle "`$\backslash$gruss"` oder "`$\backslash$closing"' haben
  die selbe Funktion. Sie setzen den Abschlu�gru� unter den Brief. Wie schon 
  bei "`$\backslash$anrede"' oder "`$\backslash$opening"' k�nnen auch hier wieder 
  Abk�rzungen eingegeben werden. Sie werden anstatt des Textes plaziert.\par
  \begin{tabular}{ll}
    mfg&   Mit freundlichen Gr��en\\
    mHg&   Mit $\heartsuit$-lichen Gr��en\\
    mhg&   Mit herzlichen Gr��en\\
    al&    Alles Liebe\\
    mvdiv& Mit vielem Dank im voraus
  \end{tabular}

  \section{{\bf $\backslash$ps}}
  {\bf Syntax:$\backslash$ps}\par
  Setzt ein {\em Postskriptum}

  \section{{\bf $\backslash$cc} oder {\bf $\backslash$kopiean}}
  {\bf Syntax:$\backslash$cc\{Text\}}\\
  {\bf Syntax:$\backslash$kopiean\{Text\}}\par

  Setzt eine Verteilerliste (Eintr�ge durch $\backslash\backslash$ abgetrennt)

  \section{{\bf $\backslash$encl} oder {\bf $\backslash$anlagen}}
  {\bf Syntax:$\backslash$encl\{Text\}}\\
  {\bf Syntax:$\backslash$anlagen\{Text\}}\par

  Setzt eine Anlagenliste (Eintr�ge durch $\backslash\backslash$ abgetrennt)

  \section{{\em $\backslash$greetings}}
  \label{greetings}
  {\bf Syntax:} $\backslash$def $\backslash$greetings\{Text\}\par
  
  In dieser Variable steht entweder die unter Punkt \ref{Gruss} auf Seite 
  \pageref{Gruss} genannten Abk�rzungen oder eine ausgeschriebene eigene 
  Grussformel. Diese Variable dient eigentlich f�r die Bestimmung der 
  Grussformel bei Serienbriefen.

  \chapter{Pers�nliche einmalige Einstellungen}

  Die hier beschriebenen Einstellungen werden einmalig in "`Briefini.\TeX"'
  eingestellt.

  \section{{\em $\backslash$@myref} und {\bf $\backslash$myref} oder {\bf $\backslash$meinzeichen}}
  {\bf Syntax:} $\backslash$def $\backslash$@myref\{Text\}\\
  {\bf Syntax:} $\backslash$myref\{Text\}\\
  {\bf Syntax:} $\backslash$meinzeichen\{Text\}\par
  
  Hier wird das K�rzel des Absenders geschrieben.

  \section{{\em $\backslash$bilddateiname}}
  {\bf Syntax:} $\backslash$def $\backslash$bilddateiname\{Text\}\par
  \label{Bild}

  Wenn ein Bild f�r die rechte obere Ecke vorhanden ist, wird er in diese 
  Variable gespeichert. Ist hier keiner eingetragen, bleibt auch die obere 
  Ecke wei�. Das Bild mu� mit BM2Font\footnote{siehe auch die Anleitung zu 
  BM2Font} umgewandelt worden sein.\\
  Z.B. existiert das Bild Logo.PCX als PCX-Datei. Dann wird dies mit BM2Font 
  mit\\
  \verb+      BM2Font -fBilddateiname.pcx+\\
  \verb+              -hAufl�sungX+\\
  \verb+              -vAufl�sungY+\\
  \verb+              -mSollbreite+\\
  \verb+              -nSollh�he+\\
  und auf das Beispiel bezogen:\\
  \verb+      BM2Font -fLogo.pcx -h360 -v360 -m15mm+\\
  Dies erzeugt die Dateien Logo.\TeX, LogoA.TFM, LogoA.PK. Es k�nnen jedoch 
  auch weitere *.TFM und *.PK, wenn das Bild zu gro� ist, um in einen 
  Zeichensatz zu passen. Dies werden dann mit LogoB.TFM bzw LogoB.PK usw. 
  benannt.

  \section{{\em $\backslash$unterschriftdateiname}}
  {\bf Syntax:} $\backslash$def $\backslash$unterschriftdateiname\{Text\}\par

  Wenn eine eingescannte und wie bei Kapitel \ref{Bild} umgewandelete 
  Unterschrift vorhanden ist, wird dies hier eingetragen. Sobald die Variable 
  leer ist, wird keine Unterschrift gedruckt.

  \section{{\em $\backslash$dateinameadresse}}
  {\bf Syntax:} $\backslash$def $\backslash$dateinameadresse\{Text\}\par

  Dateiname, aus der die Adressen genommen werden sollen.

  \section{{\em $\backslash$fromsig}}
  {\bf Syntax:} $\backslash$def $\backslash$fromsig\{Text\}\par

  Der Inhalt der Variable wird unter die Unterschrift bzw. den Platz der 
  daf�r vorgesehen ist, gesetzt.

  \section{{\em $\backslash$fromname}}
  {\bf Syntax:} $\backslash$def $\backslash$fromname\{Text\}\par

  Text der rechts oben auf dem Briefkopf erscheint.

  \section{{\em $\backslash$fromstreet}}
  {\bf Syntax:} $\backslash$def $\backslash$fromstreet\{Text\}\par

  In Text steht die Stra�e der Absenderadresse.

  \section{{\em $\backslash$fromlocation}}
  {\bf Syntax:} $\backslash$def $\backslash$fromlocation\{Text\}\par

  $\ldots$ und der Ort.
  
  \section{{\em $\backslash$fromaddress}}
  {\bf Syntax:} $\backslash$def $\backslash$fromaddress\{Text\}\par

  $\ldots$ und nochmal die komplette Adresse.
  Sie besteht meistens aus $\backslash$fromname, $\backslash$fromstreet,
  $\backslash$fromlocation.

  \section{{\em $\backslash$telephonnum}}
  {\bf Syntax:} $\backslash$def $\backslash$telephonnum\{Text\}\par

  $\ldots$ und Absendertelefonnummer.

  \section{{\em $\backslash$fax}}
  {\bf Syntax:} $\backslash$def $\backslash$fax\{Text\}\par

  $\ldots$ und die Faxnummer.

  \section{{\em $\backslash$email}}
  {\bf Syntax:} $\backslash$def $\backslash$email\{Text\}\par

  $\ldots$ und die E-Mail-Adresse.

  \section{{\em $\backslash$precode}}
  {\bf Syntax:} $\backslash$def $\backslash$precode\{Text\}\par

  $\ldots$ Vorwahl f�r Absendertelefon- und Faxnummer.

  \section{{\em $\backslash$bankname}}
  {\bf Syntax:} $\backslash$def $\backslash$bankname\{Text\}\par

  Name der Bank, bei der der Absender sein Konto hat.

  \section{{\em $\backslash$blz}}
  {\bf Syntax:} $\backslash$def $\backslash$blz\{Text\}\par

  $\ldots$ und deren Bamkleitzahl.

  \section{{\em $\backslash$ktonr}}
  {\bf Syntax:} $\backslash$def $\backslash$ktonr\{Text\}\par

  $\ldots$ und zuletzt die Kontonummer.

  \chapter[Im Brief zu definierende {\em Variablen} und {\bf Befehle}]{Benutzerdefinierte {\em Variablen} und {\bf Befehle}, die
           im Brief gesetzt werden}

  \section{{\em $\backslash$@yref} und {\bf $\backslash$yref} oder {\bf $\backslash$ihrzeichen}}
  {\bf Syntax:} $\backslash$def $\backslash$@yref\{Text\}\\
  {\bf Syntax:} $\backslash$yref\{Text\}\par
  {\bf Syntax:} $\backslash$ihrzeichen\{Text\}\par
  
  \section{{\em $\backslash$@ymail} und {\bf $\backslash$ymail} oder {\bf $\backslash$ihrnachrichtvom}}
  {\bf Syntax:} $\backslash$def $\backslash$@ymail\{Text\}\\
  {\bf Syntax:} $\backslash$ymail\{Text\}\\
  {\bf Syntax:} $\backslash$ihrnachrichtvom\{Text\}\par


  \chapter[Sprachabh�ngige Variablen]{Sprachabh�ngige Variablen in Briefini.\TeX}
  An diesen Variablen braucht normalerweise nichts eingestellt zu werden.

  \section{$\backslash$myrefname}
  \section{$\backslash$yrefname}
  \section{$\backslash$ymailname}
  \section{$\backslash$subjectname}
  \section{$\backslash$myrefname}
  \section{$\backslash$anredekurzo$\ast$}
  \section{$\backslash$anredeo$\ast$}
  \section{$\backslash$anredekurz$\ast$}
  \section{$\backslash$anredea$\ast$}
  \section{$\backslash$grusskurz$\ast$}
  \section{$\backslash$gruss$\ast$}
  
  \chapter{Serienbrief\/\/funktion}
  \index{Serienbrief}

  \begin{quote}
    {\bf Serienbrief} \cite{LexikonderInformatik}\\
    Teilgebiet: Textverarbeitung und B�roautomation\\
    Synonym: Massenpost\\
    \\
    Serienbriefe werden erstellt, wenn an unterschiedliche Personen �hnliche
    Informatioenen �bermittelt werden sollen. Dabei sind von Brief zu Brief
    nur geringe Unterschiede (z.B. die Anrede und Adresse) vorhanden. Der
    Vorgang des Einlesens der Werte in die Briefe wird Mischen genannt.
    \begin{flushright}
    Richter
    \end{flushright}
  \end{quote}

  \newpage
  \section{Adressbuch}
  F�r eine Serienbrieffunktion sollte ein Adressbuch vorhanden sein, aus 
  dem die Adressen herausgesucht werden. Diese sehen beim Style 
  "`Serienbrief"' und beim Style "`Brief"' gleich aus.\\
  Hier ein Beispiel:
  \begin{verbatim}
---
Mustermann
Marcus
Karl \& Sohn GmbH
Buchhaltung
Teststr.1
04711 Duftstadt
0815/47\,11
0815/47\/12
Marcus_Mustermann@K.maus.de
Marco
10.06.57


m
herzlich
---
Mustermann
Brigitte


Teststr.2
0815 Duftstadt
0815/12\,15


Biggi
10.11.23


w
herzlich
\end{verbatim}
usw.\par

  Neue Adressen fangen immer mit "`--\,--\,--"' an.\par

  Jede Adresse hat folgende Eintr�ge:
  \begin{verbatim}
---
Nachname
Vorname
Firmenname
Abteilung
Strasse
Ort
Telefonnummer
Faxnummer
E-Mailadresse
Cosename
Geburtsdatum
Zusatz 1
Zusatz 2
Geschlecht
Kontakt
  \end{verbatim}

  Die meisten Begriffe erkl�ren sich von selbst. Hier noch einige Erg�nzungen:
  \begin{itemize}
    \item
      {\em Nachname:}\\
      Wenn unter "`Firma"' etwas eingetragen ist, kommt in der Anschrift 
      "`z.H."' hinzu.
    \item
      {\em Abteilung:}\\
      Wenn dieser Eintrag ausgef�llt wird, wird in der Anschrift dieser unter 
      der Firma mit dem Zusatz "`Abteilung "' ausgegeben.
    \item
      {\em Cosenamen:}\\
      Wenn unter "`Kontakt"' "`herzlich"' eingetragen ist, wird bei der Anrede 
      nicht der Vorname, sondern der Cosename eingetragen. Ist dieser leer,
      wird der Vorname genommen.
    \item
      {\em Zusatz 1:}\\
      Hat bisher keine Funktion. Kann daher f�r eigene Zwecke benutzt werden,
      z.B. Faxnummer.
    \item
      {\em Zusatz 2:}\\
      Hat bisher keine Funktion. Kann daher f�r eigene Zwecke benutzt werden.
    \item
      {\em Geschlecht}\\
      Wie der Name schon sagt, ist dieser Eintrag f�r die Unterscheidung des 
      Geschlechtes:\\
      "`w"' weiblich\\
      "`m"' m�nnlich\\
      "`n"' neutral\\
    \item
      {\em Kontakt}\\ 
      Hiermit wird das Verh�ltnis zwischen Briefschreiber und Empf�nger 
      angegeben:
      \begin{itemize}
        \item
          "`herzlich"'\\
          Es wird eine pers�nliche Anrede und Grussformel angegeben, z.B.
          "`Liebe Biggi"' und "`Mit $\heartsuit$-lichen Gr��en"'.
        \item
          "`formal"'\\
          Es wird eine unpers�nlichere Anrede und Grussformel angegeben, z.B.
          "`Sehr geehrte Frau Mustermann"' und "`Mit freundlichen Gr��en"'.
      \end{itemize} 
  \end{itemize}
  Zwischen dem letzten Eintrag einer Adresse (Kontakt) kann noch beliebiger 
  Text folgen. Wichtig ist nur, da� die n�chste Adresse mit "`--\,--\,--"'
  anf�ngt.\par

  Die verschiedenen Felder stehen im Text auch zur Verf�gung. Sie werden �ber folgende Variablen 
  aufgerufen:
  \begin{verbatim}
    \nachname
    \vorname
    \firma
    \abteilung
    \strasse
    \ort
    \tel
    \fax
    \email
    \cosename
    \geburtsdatum
    \paraer
    \parazw
    \geschlecht
    \kontakt
  \end{verbatim}
\pagebreak
  {\em Beispiel 1:} Im Feld $\backslash$paraer soll die 2.Telefonnummer stehen. 
  Wenn nun eine 2. Nummer vorhanden ist, soll dies im Text stehen.
  \begin{verbatim}
\ifx\paraer\empty
  Ein 2. Telefonanschlu\3 ist nicht vorhanden.
\else
  Ein 2. Telefonanschlu� ist unter der Nummer \paraer zu erreichen.
\fi
  \end{verbatim}
  {\em Beispiel 2:} Bei den Briefen soll unterschieden werden, ob die 
  angesprochene Person ge"`sie"'st wird.
  \begin{verbatim}
\def\test{herzlich}
Wenn 
\ifx\kontakt\test
  Du
\else
  Sie
\fi
morgen kommen
\ifx\kontakt\test
  k"onntest,
\else
  k"onnen,
\fi
w"urde ich mich sehr freuen.
  \end{verbatim}
Durch diese Abfragen sind nat�rlich sehr indviduelle Briefe m�glich. 
Es sieht zwar sehr kompliziert aus, ist aber ein sehr m�chtiges Werkzeug f�r 
Serienbriefe. Weiteres aber unter Kapitel \ref{Aufruf und Funktion} auf Seite
\pageref{Aufruf und Funktion}.

\section{Aufruf und Funktion}
\label{Aufruf und Funktion}
{\bf Syntax:} $\backslash$serienbrief[Suchkriterium]\{Suchtext\}\par
Folgende {\em Suchkriterien} stehen zur Verf�gung:\par
\begin{tabular}{l@{ f�r die Suche in }l}
{\em Nachname} & \verb+\nachname+\\
{\em Vorname}  & \verb+\vorname+\\
{\em Firma} & \verb+\firma+\\
{\em Abteilung}  & \verb+\abteilung+\\
{\em Stra�e} & \verb+\strasse+\\
{\em Ort}  & \verb+\ort+\\
{\em Telefonnummer} & \verb+\tel+\\
{\em Faxnummer}  & \verb+\fax+\\
{\em E-Mail} & \verb+\email+\\
{\em Cosename} & \verb+\cosename+\\
{\em Geburtsdatum}  & \verb+\geburtsdatum+\\
{\em Zusatz 1} & \verb+\paraer+\\
{\em Zusatz 2} & \verb+\parazw+\\
{\em Geschlecht} & \verb+\geschlecht+\\
{\em Kontakt}  & \verb+\kontakt+
\end{tabular}\par
{\em Suchtext} kann jede beliebige Zeichenfolge sein, die in dem Suchkriterium 
vorkommen soll.\\
Mit der Variable \verb+\greetings+ kann die Abschlu�gru�formel gesetzt werden.
Siehe dazu auch unter Kapitel \ref{Gruss} auf Seite \pageref{Gruss} und Kapitel
\ref{greetings} auf Seite \pageref{greetings}.\par

\subsection{Beispiele:}

\verb+\serienbrief[Geschlecht]{w}+ schreibt einen Brief mit dem Text $\backslash$text an 
alle Frauen, die in der Adressdatei stehen.\\
\verb+\serienbrief{Frank}+ schreibt einen Brief mit dem Text $\backslash$text an alle die den 
Nachnamen "`Frank"' haben.

\chapter{Geschichte}
\begin{itemize}
  \item
    \underline{2.3.94} 0.53$\beta$\\
    Kleinere �nderungen:\\
    Schriftgr��e 10pt jetzt auch m�glich.\\
    Bei Serienbriefen kann jetzt auch ein eigene Gru�formel gesetzt werden.\\
    Faxnummer und E-Mailadresse ist jetzt in der Adressenliste hinzugekommen.\\
    In der Adressendatei brauchen nicht mehr die \% hinter jeder Zeile erscheinen.
  \item
    \underline{28.2.94} 0.52$\beta$\\
    Kleinere �nderungen:\\
    Bei Kontakt kann jetzt nur noch "`m"', "`w"', "`n"' angegeben werden.\\
    Ungewollte Kontrollausgabe bei Serienbrief ist weggefallen.\\
    Fehler bei nicht angegebenen Nachnamen behoben.\par
    Erste Version der Anleitung.\par
    Die Serienbrief\/funktion gibt es nun auch einzeln, um sie auch mit anderen
    Letter-Styles zu benutzen.
  \item
    \underline{26.2.94} 0.51$\beta$\\
    Kleinere �nderungen:\\
    Seitenl�nge wird bei der Angabe der vollen Adresse in der Fu�zeile 
    angepa�t.\\
    Neu:\\
    Bei der Faxoption wird jetzt in der Statuszeile die Gesamtseitenzahl 
    angegeben.
  \item
    \underline{24.2.94} 0.50$\beta$\\
    Erste offizelle Betaversion\\
    Neu: Serienbrief\/funktion
  \item
    \underline{15.1.94} 0.4$\beta$\\
    Interne Version
    Neu: Adressbuchfunktion
  \item
    \underline{20.10.92} 0.1$\beta$\\
    Interne erste Version\\
\end{itemize}
\begin{appendix}
  \bibliographystyle{plain}
  \bibliography{brief}
  \printindex
\end{appendix}

\end{document}
