\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{Einfhrung}

  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[Abkrzungen]\{Name\}\\
  {\bf Syntax:} $\backslash$anrede[Abkrzungen]\{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 Abkrzung
  angegeben ist, oder nur der Vor- oder Nachname.\\
  Wenn keine Abkrzung angegeben ist, k”nnen die eckigen Klammern wegfallen.\par
  Folgende Abkrzungen 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 
  Abkrzungen 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 Abkrzungen oder eine ausgeschriebene eigene 
  Grussformel. Diese Variable dient eigentlich fr 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 Krzel des Absenders geschrieben.

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

  Wenn ein Bild fr 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 
  dafr 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 fr 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 Broautomation\\
    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}
  Fr 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 ausgefllt 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 fr eigene Zwecke benutzt werden,
      z.B. Faxnummer.
    \item
      {\em Zusatz 2:}\\
      Hat bisher keine Funktion. Kann daher fr eigene Zwecke benutzt werden.
    \item
      {\em Geschlecht}\\
      Wie der Name schon sagt, ist dieser Eintrag fr 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 Verfgung. 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 natrlich sehr indviduelle Briefe m”glich. 
Es sieht zwar sehr kompliziert aus, ist aber ein sehr m„chtiges Werkzeug fr 
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 Verfgung:\par
\begin{tabular}{l@{ fr 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}
