From 4ced46483f40846bb18f28d2ab0011fceb84b9e9 Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Wed, 8 Aug 2007 17:55:43 +0000
Subject: adrconv update (12nov06)

git-svn-id: svn://tug.org/texlive/trunk@4718 c570f23f-e606-0410-a88d-b1316a301751
---
 Master/texmf-dist/doc/latex/adrconv/adrguide.tex | 83 ++++++++++++++++++------
 1 file changed, 62 insertions(+), 21 deletions(-)

(limited to 'Master/texmf-dist/doc/latex/adrconv/adrguide.tex')

diff --git a/Master/texmf-dist/doc/latex/adrconv/adrguide.tex b/Master/texmf-dist/doc/latex/adrconv/adrguide.tex
index 547e6dca80f..ef5cd5ab908 100644
--- a/Master/texmf-dist/doc/latex/adrconv/adrguide.tex
+++ b/Master/texmf-dist/doc/latex/adrconv/adrguide.tex
@@ -1,4 +1,35 @@
+%% adrguide.tex
+%% Copyright 2006 Axel Kielhorn
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+%   http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2003/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+% 
+% This Current Maintainer of this work is Axel Kielhorn (A.Kielhorn@web.de)
+%
+% This work consists of the files adrconv.ins, adrconv.dtx, adrguide.tex
+% and the derived file adrguide.pdf. 
+%
+% Use
+%   tex adrconv.ins
+% or
+%   latex adrconv.ins
+% to generate the other files, which are indirect parts of the
+% bundle. Use
+%   latex adrconv.dtx
+% to generate the implementation documentation. Use
+%   latex adrguide.tex
+% to generate the user documentation.
+
 \documentclass{article}
+\usepackage[T1]{fontenc}
+\usepackage{ae}
 \usepackage{german}
 
 \newcommand*{\File}[1]{\texttt{#1}}
@@ -8,9 +39,9 @@
 \DeclareRobustCommand{\KOMAScript}{\textsf{K\kern.05em O\kern.05em%
       M\kern.05em A\kern.1em-\kern.1em Script}}
 
-\title{ADRconv Anleitung\\Version 1.2b}
-\author{Axel Kielhorn}
-\date{31. Mai 2003}
+\title{ADRconv Anleitung\\Version 1.2c}
+\author{Axel Kielhorn\thanks{A.Kielhorn@web.de}}
+\date{19. April 2006}
 \begin{document}
 
 \maketitle
@@ -78,6 +109,19 @@ in einer \File{bib}-Datei:
      birthday =  {13. August anno muri},
      nbirthday = {0813}
   }
+  @address{OEKZ,
+     name =      {{{"O}kologisches Zentrum~e.\,V.}},
+     sortas =    {Okologisches Zentrum},
+     organization = {Verband der Vereine},
+     city =      {Heimstatt},
+     zip =       01234,
+     country =   {Germany},
+     street =    {Mauerstra{\ss}e 1},
+     phone =     {01234 / 5 67 89},
+     fax =       {01234 / 5 67 89},
+     email =     {hm{@}work.com},
+     key =       {OEKZ},
+  }
 \end{verbatim}
 \end{small}
 
@@ -89,6 +133,11 @@ ausf"uhrliche Form zeigt die Version~1.2.
 \begin{description}
 	\item[name]  Der Name im normalen Bib\TeX\ Format: Vorname von 
 	Nachname
+	
+	\item[sortas] Wenn der Name mit einem Umlaut beginnt, wird er falsch
+	einsortiert, bei der Verwendung von UTF-8 kodierten Datenbanken kommt
+	es sogar zu einem Bib\TeX\ Fehler. \texttt{sortas} hat Vorrang vor
+	\texttt{name}. (Neu in Version 1.2c.)
 
 	\item[title] Akademischer Titel oder "ahnliches (Wird z.\,Zt.  
 	nicht unterst\"{u}tzt)
@@ -113,7 +162,7 @@ ausf"uhrliche Form zeigt die Version~1.2.
 	Erstellen eines Telefaxbuches verwendet.
 	
 	\item[email] E-mail Adresse, wird von \File{email.bst} zum 
-	erstellen eines E-mail Verzeichnisses benutzt.
+	Erstellen eines E-mail Verzeichnisses benutzt.
 	
 	\item[url] Ein Link auf die Homepage. Hier w"are jetzt ein Konverter 
 	nach HTML gefragt.
@@ -258,6 +307,7 @@ der so aussehen k"onnte:
 \begin{verbatim}
   @address{DANTE,
   name      = {{DANTE~e.\,V.}},
+  sortas    = {Dante},
   street    = {Postfach 10 18 40},
   zip       = {69008},
   city      = {Heidelberg},
@@ -337,7 +387,7 @@ Die konvertierte Adressdatei hat folgenden Inhalt:
   {Langer Weg 17 \\ 
    38118 Braunschweig}{0531 / 113 34 89}{}{}{}{}
   \adrentry{Kohlmeise}{Rudolf}
-  {Stra{\ss}e des 11.~September 17 \\ 
+  {Stra{\ss}e des 11.~September 73 \\ 
    12345 Neu Jorg}{0513 / 89 55 66}{}{}{}{}
   \adrentry{Kuchennascher}{Mattse}
   {Fichtenstra{\ss}e 1 \\ 
@@ -348,24 +398,16 @@ Die konvertierte Adressdatei hat folgenden Inhalt:
   {Einbahnstra{\ss}e 1 \\ 
    01234 Heimstatt}{01234 / 5 67 89}{}{}{}{}
 
-  \adrchar{{}
+  \adrchar{D}
   \adrentry{{DANTE~e.\,V.}}{}
   {Postfach 10 18 40 \\ 
    69008 Heidelberg}{0 62 21 / 2 97 66}{}{}{}{DANTE}
 \end{verbatim}
 \end{small}
 
-Der fehlende Vorname f"uhrt hier zu einem Fehler im 
-\Macro{adrchar}-Eintrag. Nachdem Sie ihn in:
-
-\begin{small}
-\begin{verbatim}
-  \adrchar{D}
-\end{verbatim}
-\end{small}
+In Version 1.2~c musste man den \Macro{adrchar}-Eintrag noch von Hand korrigieren, durch den \texttt{sortas}-Eintrag erfolgt das nun automatisch.
 
-verbessert und zusammen mit dem Adress-Eintrag an die richtige Stelle
-verschoben haben, k"onnen Sie einen Brief an DANTE~e.\,V. dann 
+Einen Brief an DANTE~e.\,V. k"onnen Sie  
 mit Hilfe der \KOMAScript{} Briefklasse so beginnen:
 
 \begin{small}
@@ -384,11 +426,10 @@ Adressdatenbank vorgenommen haben.
 
 Bitte beachten Sie dabei, dass die drei Programme zum Erzeugen der
 \File{aux}-Datei (\File{adrconv.tex}, \File{birthday.tex} und
-\File{email.tex}) sowohl mit (Plain)\TeX{} als auch mit \LaTeX{}
-aufgerufen werden k"onnen, w"ahrend die beiden Programme
-\File{dir.tex} und \File{phone.tex}, die Sie nach erfolgreicher
-Konvertierung auf Ihre Adressdatei anwenden k"onnen, um daraus fertige
-Adress-, E-Mail- bzw. 
+\File{email.tex}) sowohl mit (Plain)\TeX{} als auch mit \LaTeX{} aufgerufen
+werden k"onnen, w"ahrend die beiden Programme \File{dir.tex} und
+\File{phone.tex}, die Sie nach erfolgreicher Konvertierung auf Ihre
+Adressdatei anwenden k"onnen, um daraus fertige Adress-, E-Mail- bzw.
 Telefonverzeichnisse zu produzieren, nur mit \LaTeX{}
 funktionieren.
 
-- 
cgit v1.2.3

