archaeologie (28feb17)

git-svn-id: svn://tug.org/texlive/trunk@43357 c570f23f-e606-0410-a88d-b1316a301751

6 files changed, 177 insertions, 53 deletions

diff --git a/Master/texmf-dist/doc/latex/archaeologie/CHANGELOG.md b/Master/texmf-dist/doc/latex/archaeologie/CHANGELOG.md
new file mode 100644
index 00000000000..d6ae14d4d2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/archaeologie/CHANGELOG.md
@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+This project **does not** adhere to [Semantic Versioning](http://semver.org/).
+The markdown syntax is inspired by the conventions proposed by [keepachangelog.com](http://keepachangelog.com/).
+
+## [unreleased]
+
+
+## v2.3 (2017-02-27)
+#### *fixed*
+* empty space deleted after bibliography entries (has only been visible when using option `seenote`)
+* typo in the German documentation
+* related example in German documentation corrected
+
+#### *added* 
+* get the translator of an ancient opus with `\citetranslator` or `\citetranslator*`
+* more citation commands (`\smartcite`; `\autocite`; `\fullcite`; `\footfullcite`)
+* support for `polyglossia`
+
+## v2.2b (2016-10-06) --> [current release]
+* *typo* <br> documentation with new style
+
+## v2.2 (2016-09-25)
+* *added* <br> `uniqueme` for variant translations of ancient works.
+* *added* <br> bibliography-file `archaeologie-examples.bib` included
+
+
+[current release]: http://www.biblatex-archaeologie.de
+[unreleased]: http://github.com/LukasCBossert/biblatex-archaeologie
+
diff --git a/Master/texmf-dist/doc/latex/archaeologie/README.md b/Master/texmf-dist/doc/latex/archaeologie/README.md
index 49ac37f31ae..7506245ba75 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/README.md
+++ b/Master/texmf-dist/doc/latex/archaeologie/README.md
@@ -5,15 +5,15 @@ bibLaTeX-__archaeologie__
 
 bibLaTeX-style for archaeologists, historians and philologists.
 ---
-_2016/10/06 v2.2b_
+_2017/02/27 v2.3_
 
-Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
+Copyright (c) 2017 Lukas C. Bossert | Johannes Friedl
 
 * Email: [info@biblatex-archaeologie.de](mailto:info@biblatex-archaeologie.de)
-* Website: [www.biblatex-archaeologie.de](www.biblatex-archaeologie.de)
+* Website: [www.biblatex-archaeologie.de](http://www.biblatex-archaeologie.de)
 
 This citation-style covers the citation and bibliography rules of 
-the [__German Archaeological Institute__ (DAI)](http://www.dainst.org/dai/meldungen). 
+the [__Deutsches Archäologisches Institut__ (DAI)](http://www.dainst.org/dai/meldungen). 
 Various options are available to change and adjust 
 the outcome according to one’s own preferences.
 (German, English, Italian, French, Spanish)
@@ -43,7 +43,7 @@ mandatory:
 
 language files:
 
-- archaeologie-ngerman.lbx
+- archaeologie-german.lbx
 - archaeologie-english.lbx
 - archaeologie-french.lbx
 - archaeologie-italian.lbx
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
index 7e5e2435b13..b922168ebb7 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
index e572c4956d1..cd9897cfd86 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
@@ -1,7 +1,7 @@
 % archaeologie --%
 %            biblatex for archaeologists, 
 %				historians and philologists
-% Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
+% Copyright (c) 2017 Lukas C. Bossert | Johannes Friedl
 %  
 % This work may be distributed and/or modified under the
 % conditions of the LaTeX Project Public License, either version 1.3
@@ -10,7 +10,7 @@
 %   http://www.latex-project.org/lppl.txt
 % and version 1.3 or later is part of all distributions of LaTeX
 % version 2005/12/01 or later.
-%!TEX program = xelatex
+% !TEX program = lualatex
 \documentclass[a4paper,10pt,ngerman]{ltxdoc}
 \input{archaeologie-preamble.tex}
 \externaldocument{archaeologie}[archaeologie.pdf]% <- full or relative path
@@ -26,9 +26,9 @@ Weitere Informationen zum Code und zur Weiterentwicklung siehe \url{biblatex-arc
  
  \maketitle
  \begin{abstract}
-\noindent Der Stil setzt die Zitations- und Bibliographievorgaben um, die das \textbf{Deutsche Archäologische Institut (DAI)}  2014 festgelegt hat. 
+\noindent Der Stil setzt die Zitations- und Bibliographievorgaben um, die das \DAI (DAI)  2014 festgelegt hat. 
 Verschiedene zusätzliche Optionen erlauben jedoch, das Erscheinungsbild den eigenen Vorlieben anzupassen. 
-Der Stil ist nicht nur für Dokumente in deutscher Sprache geeignet, sondern unterstützt ebenso die Sprachen Englisch, Italienisch und Französisch. 
+Der Stil ist nicht nur für Dokumente in deutscher Sprache geeignet, sondern unterstützt ebenso die Sprachen Englisch, Italienisch, Spanisch und Französisch. 
 
 Dieses Dokument ist die deutsche Kurzfassung der englischen Hauptdokumentation: Für eine vollständige Anleitung siehe die englische Stilbeschreibung  \href{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie/archaeologie.pdf}{\textbf{online}} oder \href{file:archaeologie.pdf}{\textbf{lokal}}.
  \end{abstract}
@@ -185,10 +185,16 @@ Dies ist vor allem bei Lexikaeinträgen wichtig: (LIMC 7.1 [1994] 930 Nr. 283 s.
 \DescribeMacro{\textcite}  \DescribeMacro{\textcites}  Zu den bisher aufgeführten \cs{cite}-Befehlen gibt es zusätzlich die Möglichkeit, einen Eintrag \enquote{fließtextgerecht} mit \cs{textcite} zu zitieren. 
 Der Unterschied zu \cs{cite} besteht darin, dass der Literaturverweis durch Klammern vom Autor getrennt wird: z.\,B. Emme (2013, 5).
 \cs{textcite} und \cs{textcites} verhalten sich in der Bedienung analog zu \cs{cite} und \cs{cites}.
-
+ 
 \DescribeMacro{\citeauthor}  \DescribeMacro{\citetitle}  Diese Befehle ermöglich, nur einzelne Elemente einer Publikation zu zitieren. Je nach Verwendung wird entweder nur der Titel oder der Autor eines Bibliographieeintrages ausgegeben. Ein Vorteil gegenüber des händischen Eintippens eines solchen Elementes ist, dass der Eintrag indiziert und referenziert wird. Dies kann z.\,B. für einen (Autoren-)Index, der auf die Textstelle verweisen soll, relevant sein.
    
+\DescribeMacro{\citetranslator} Zusätzlich gibt es noch die Möglichkeit den Übersetzer eines (insbesondere) antiken Werkes anzugeben. 
+Besonders wenn man einen antiken Text in Übersetzung zitiert, ist es üblich den Urheber der Übersetzung anzugeben.
+Ist kein Übersetzer vorhanden, dann gibt der Befehl einen selbst als Übersetzer an.
 
+ \DescribeMacro{\citetranslator*} Die Sternchen-Variante gibt zusätzlich noch die Sprache an, 
+ aus der übersetzt wurde.
+ 
 \section{Publikationstypen}
 Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry Type}) und ihre von |archaeologie| ausgelesenen Felder (\emph{Data Field}) aufgelistet.
 
@@ -206,7 +212,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[7em]{Fentress2003}
+\printbib[7em]{Emme2013}
 
  
 \DescribeMacro{@inbook}  \DescribeMacro{@incollection}  Für Beiträge innerhalb eines Sammelbandes.
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
index 7aa5b91755d..95a89ca6b40 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
index 30784ab551c..6866aa5e413 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
@@ -1,7 +1,7 @@
 % archaeologie --%
 %            biblatex for archaeologists, 
 %        historians and philologists
-% Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
+% Copyright (c) 2017 Lukas C. Bossert | Johannes Friedl
 %  
 % This work may be distributed and/or modified under the
 % conditions of the LaTeX Project Public License, either version 1.3
@@ -10,7 +10,7 @@
 %   http://www.latex-project.org/lppl.txt
 % and version 1.3 or later is part of all distributions of LaTeX
 % version 2005/12/01 or later.
-%!TEX program = xelatex
+% !TEX program = lualatex
 \documentclass[a4paper,
 10pt,
 greek,
@@ -24,8 +24,8 @@ english
 \externaldocument{archaeologie-ger}[archaeologie-ger.pdf]% <- full or relative path
 
 \begin{document}
-\title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} for archaeologists\footnote{Also very handy as well for (ancient) History or Classics.
-Further information about the code online visit \href{http://www.biblatex-archaeologie.de}{www.biblatex-archaeologie.de}: 
+\title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} for archaeologists\footnote{Also very handy for (ancient) History or Classics, too.
+For further information about the code visit \href{http://www.biblatex-archaeologie.de}{biblatex-archaeologie.de}: 
 Comments and criticisms are welcome.
 We thank  ›moewew‹ and Herbert Voß for their big help on the code.%
 }}
@@ -35,11 +35,12 @@ We thank  ›moewew‹ and Herbert Voß for their big help on the code.%
 \maketitle
 
 \begin{abstract}
-\noindent This citation-style covers the citation and bibliography rules of the German Archaeological Institute (\textbf{Deutsches Archäologisches Institut}). 
+\noindent This citation-style covers the citation and bibliography rules of the \DAI (DAI). 
 Various options are available to change and adjust the outcome according to one's own preferences. 
 The style is compatible with the English, German, Italian, Spanish and French languages, since all |bibstrings| used are defined in each language.
+\bigskip
 
-For a short introduction in German see   \href{pdfdeu.biblatex-archaeologie.de}{\textbf{online}} or   \href{file:archaeologie-ger.pdf}{\textbf{local}}.
+\noindent For a short introduction in German see   \href{pdfdeu.biblatex-archaeologie.de}{\textbf{online}} or   \href{file:archaeologie-ger.pdf}{\textbf{local}}.
 \end{abstract}
 
 
@@ -82,7 +83,7 @@ Here is some additional information from the UK \TeX\ FAQ:
 \bibliography*@\marg{|bib|-file}@*
 \end{code}
 
-Without any further options the style follows the rules of the German Archaeological Institute. 
+Without any further options the style follows the rules of the \DAI. 
 No additional settings are needed,
 but you can change the outcome by using some options which are explained below.\footnote{For an easy and unproblematic compiling we suggest to use \hologo{XeLaTeX} or  \hologo{LuaTeX}.}
 
@@ -109,7 +110,7 @@ Additionally this activates the bibliography |archaeologie-lstabbrv.bib|.
 \DescribeMacro{lstabbrv}
 Activates the additional bibliography file |archaeologie-lstabbrv.bib|.
 It provides a list of journals and series according to the abbreviations of the 
-German Archaeological Institute which can be used as |@String| macros in bibliography entries; cf. \cref{abbrv}. 
+\DAI which can be used as |@String| macros in bibliography entries; cf. \cref{abbrv}. 
 
 \DescribeMacro{lstlocations}
 Activates the additional bibliography file |archaeologie-lstlocations.bib|
@@ -144,7 +145,7 @@ Switches \enquote{ed.}/\enquote{Hrsg.} to \enquote{ed. by}/\enquote{hrsg. v.}; c
 
 \DescribeMacro{inreferences}
 Each bibliography entry which is an |@Inreference| is fully referenced according to the special rules of the 
-German Archaeological Institute for manuals and encyclopaedias; cf. \cref{inreferences}.
+\DAI for manuals and encyclopaedias; cf. \cref{inreferences}.
 
 \DescribeMacro{noabbrv}
 By default the short titles of journals and series (|shortjournal| and |shortseries|) are shown in the bibliography.
@@ -156,7 +157,7 @@ It also changes the format of the edition and the first print; cf. \cref{publish
 
 \DescribeMacro{seenote}
 By default |archaeologie| prints author-year-system. 
-With this option you can change it to a different outcome (but still according to the rules of the German Archaeological Institute). 
+With this option you can change it to a different outcome (but still according to the rules of the \DAI). 
 So the first citation will be a full citation and all the following citations will refer to the first full citation; cf. \cref{seenote}
 
 \DescribeMacro{translation}
@@ -226,21 +227,6 @@ If one wants to cite several authors or works a very convenient way is the follo
 \begin{example}
 Public space is part of a city say \cites(cf.)(){Osland2016}{Evangelidis2014}.
 \end{example}
-
- \DescribeMacro{\footcite}
- There is also the possibility to put the citation into a footnote at once with \cs{footcite}:
- \begin{code}
-\footcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*
-\end{code}
-\begin{example}
-Public space is part of a city.\footcite{Osland2016}
-\end{example}
-This is the equivalent to |\footnote{\cite{Osland2016}.}| but it saves you a lot of time typing.
- \DescribeMacro{\footcites} And there is as well \cs{footcites}:
-\begin{example}
-Public space is part of a city.\footcites(cf.)(){Osland2016}{Evangelidis2014}
-\end{example}
- 
  
 \DescribeMacro{\parencite}
 Sometimes a citation has to be put in parentheses. 
@@ -289,9 +275,80 @@ And again there is also a \cs{textcites} in case of several authors:
   *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
 \end{code}
 \begin{example}
-Public space is part of a city say \textcites{Osland2016}[cf.][]a{Evangelidis2014}.
+Public space is part of a city say \textcites{Osland2016}[cf.][]{Evangelidis2014}.
+\end{example}
+
+
+ \DescribeMacro{\footcite}
+ Beside the listed \cs{cite} commands above there are more possibilities citing:
+ There is also the possibility to put the citation into a footnote at once with \cs{footcite}:
+ \begin{code}
+\footcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*
+\end{code}
+\begin{example}
+Public space is part of a city.\footcite{Osland2016}
+\end{example}
+This is the equivalent to |\footnote{\cite{Osland2016}.}| but it saves you a lot of time typing.
+ \DescribeMacro{\footcites} And there is as well \cs{footcites}:
+\begin{example}
+Public space is part of a city.\footcites(cf.)(){Osland2016}{Evangelidis2014}
+\end{example}
+ 
+ 
+\DescribeMacro{\smartcite}
+And there is also a clever way citing with \cs{smartcite}.
+\cs{smartcite} depends on its environment it is used in. If it is your normal text it behaves like \cs{footcite} and will print the citation within a footnote.
+If it is already within a footnote it will be handled like \cs{cite}. 
+ is a clever 
+\begin{code}
+\smartcite*@\oarg{postnote}\marg{bibtex-key}%@*
+\end{code} 
+
+\begin{example}
+Public space is part of a city.\smartcite{Osland2016} 
+And sometimes more than that.\footnote{\smartcite[cf.][]{Evangelidis2014}.}
+\end{example}
+
+
+\DescribeMacro{\smartcites}
+And again there is also a \cs{textcites} in case of several authors: 
+\begin{code}
+\smartcites(pre-prenote)(post-postnote)%
+  *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+  *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+  *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
+\end{code}
+\begin{example}
+Public space is part of a city.\smartcites{Osland2016}{Evangelidis2014} 
+And sometimes more than that.\footnote{\smartcites{Osland2016}[cf.][]{Evangelidis2014}.}
+\end{example}
+
+\DescribeMacro{\autocite}
+With \cs{autocite} there is a flexible way of citing. 
+We set up \cs{autocite} as \cs{footcite} by default.
+If you want to change it you can also write in the preamble e.\,g. |autocite=inline|.
+\begin{code}
+\autocite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
+\end{code} 
+
+\begin{example}
+Public space is part of a city.\autocite{Osland2016} 
+\end{example}
+
+\DescribeMacro{\fullcite}\DescribeMacro{\footfullcite}
+With \cs{fullcite} and \cs{footfullcite} you can print the complete entry in your current text.
+\begin{code}
+\fullcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*
+\footfullcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*
+\end{code} 
+
+\begin{example}
+Public space is part of a city.\footfullcite{Osland2016}
+As can be read in \fullcite{Evangelidis2014}
 \end{example}
 
+
+
 \DescribeMacro{\citeauthor}\DescribeMacro{\citetitle}\label{citeauthor}%
 Furthermore and in addition to the ›normal‹ \cs{cite}-commands one can also cite only the author or the work title in the text and in the footnotes.
 \begin{code}
@@ -307,13 +364,36 @@ Public space is part of a city says \citeauthor{Osland2016} in \citetitle{Osland
 \end{example}
 For further information cf. \cref{citeauthorformat}.
 
+\DescribeMacro{\citetranslator}\label{citetranslator}%
+Addionally there is also a \cs{cite}-command which can be used to print the translator of an (ancient) work.
+\begin{code}
+\citetranslator*@\marg{bibtex-key}%@*
+\end{code}
+This will print the name(s) of the translator according to the chosen |citeauthorformat|.
+If there is no translator it will name you as translator (\enquote{own translation}).
+\begin{code}
+\citetranslator* *@\marg{bibtex-key}%@*
+\end{code} 
+\newcommand\latquote[5]{\cite[#1][#2]{#3}: \emph{#4} -- \enquote{#5} \parentext{\citetranslator*{#3}}.}
+
+The starred version prints also the informtion from which language the text has been translated.
+For an efficient way of citing ancient texts we introduce a new command (only a suggestion):
+\begin{code}
+\newcommand\latquote[5]{\cite[#1][#2]{#3}: \emph{#4} -- \enquote{#5} \parentext{\citetranslator*{#3}}.}
+\end{code}
+\begin{example}
+\latquote{cf.}{12,25,1}{Cic:Att}{sed domus est, ut ais, forum}{Aber dein Heim ist das Forum.}
+\end{example}
+
+
+
 \subsection{Entries with @String}\label{string}
-The citation rules of the German Archaeological Institute instruct to abbreviate journals and series according to a given list.\footnote{\url{http://www.dainst.org/documents/10180/70593/03_Liste+abzukürzender+Zeitschriften_quer.pdf/2646d351-8e5d-4e8b-8acd-54f3c272d3ff} <2016-06-06>}
+The citation rules of the \DAI instruct to abbreviate journals and series according to a given list.\footnote{\url{http://www.dainst.org/documents/10180/70593/03_Liste+abzukürzender+Zeitschriften_quer.pdf} <2016-06-06>}
 For this purpose we provide a list with bibliography macros which refer to these abbreviations. 
 These abbreviations can be included by loading package option |lstabbrv| (cf. \cref{abbrv}). 
 Besides there are two further lists with |@String| macros cf. \cref{lstpublishers,lstlocations}.
 
-\DescribeMacro{@String} The style |archaeologie| respects the guidelines of the German Archaeological Institute 
+\DescribeMacro{@String} The style |archaeologie| respects the guidelines of the \DAI 
 and is therefore compatible with the given abbreviations of journals and series.
 To minimize the susceptibility to errors and to omit unnecessary typing of sometimes very long journal titles |archaeologie| works with so-called |@Strings|.
 The advantage of these |@Strings| is that several bibliography entries can be defined by one globally given value. 
@@ -321,7 +401,7 @@ The |@String| is loaded at begin of the |bib|-file, therefore all |@Strings| hav
  
 To use this offer of simplification the following bibliography fields should be field with such a a |@String|: |journaltitle| and |shortjournal|,
 (|series| and |shortseries|.
-In \cref{abbrv-lists} there is a list with all the abbreviations given by the German Archaeological Institute, 
+In \cref{abbrv-lists} there is a list with all the abbreviations given by the \DAI, 
 in which the |@String| (with endings |-short| for |shortjournal| or |shortseries|) are listed in the left column.  
 An |@String| has to be written \emph{without} any curly brackets.\footnote{If you use \emph{JabRef} in its non-coding window, 
 then you have to write \#|AyasofyaMuezYil|\#. 
@@ -394,8 +474,8 @@ Changes made by these options are {\color{red}coloured in red}.
 Optional preferences in the preamble are loaded within the package |bib|\LaTeX:
 \begin{code}
 \usepackage[%        
-    backend=biber,  % activates biber which is done by default anyway 
-                    %  (but will give an error if not done here)
+    backend=biber,  % activates biber (default; 
+                    % but will give an error if not done)
     style=archaeologie,   % loads the style *@|archaeologie|@*
     inreferences=true,    % option *@|inreferences|@* is loaded
     lstabbrv              % option *@|lstabbrv|@* is loaded as well
@@ -501,7 +581,7 @@ For the list, cf. \cref{list-publishers}
 \subsubsection{seenote}\label{seenote}
 \DescribeMacro{seenote}
 Even if author-year-citation seems to be commonly accepted in Ancient Studies in the meantime you may want to use a traditional citation style. 
-For this purpose you can switch to the other allowed citation rule by the German Archaeological Institute
+For this purpose you can switch to the other allowed citation rule by the \DAI
 which works like this:
 If you cite a work for the first time in a footnote |archaeologie| will print a full cite which contains all bibliography elements.
 Henceforward each following citation is printed as short cite and will additionally refer to the footnote where the first cite was done.
@@ -611,7 +691,7 @@ There are two ways to display this entry:
  \begin{tcolorbox}[examplebox]
  |\footnote{\cite{Nieddu1995}.}|
  \tcblower
-\footnote{LTUR 2 (1995) 9f. s. v. Dei Consentes (G. Nieddu).}
+\footnote{LTUR 2 (1995) 9\,f. s. v. Dei Consentes (G. Nieddu).}
  \end{tcolorbox}
   \end{enumerate}
 
@@ -634,7 +714,7 @@ then it will change the position for the \oarg{postnote}:
 
 \begin{marker}
     Activating |inreferences=true| causes the cited |@Inreference| entry to be automatically \emph{omitted} in the (final) bibliography,
-because the entry is fully cited before in the footnotes (also stated in the German Archaeological Institute rules).
+because the entry is fully cited before in the footnotes (also stated in the \DAI rules).
 \end{marker}
 
 If the option is not used (|inreferences=false|) the entry will look like this in the bibliography:
@@ -856,7 +936,7 @@ to
 
 \begin{bibbox}{Ball2013}\footnotesize
 \parbox[t]{3cm}{{\scshape \color{red}Ball – Dobbins} 2013}\parbox[t]{8.5cm}{%
-L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492\newline
+L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492,\newline
 ...}
 \end{bibbox}
 
@@ -896,7 +976,7 @@ and with |bibfullname| it will change to:
 
 \subsubsection{noabbrv}\label{noabbrevs}
 \DescribeMacro{noabbrv}
-According to the guidelines of the German Archaeological Institute journal titles and series have to be abbreviated.
+According to the guidelines of the \DAI journal titles and series have to be abbreviated.
 Therefore the fields |shortjournal| or |shortseries| will be considered. 
 If you like to have printed full names of journals and series instead you can switch on the option |noabbrv|.
 For an example see \cref{string,Koyunlu1990}.
@@ -1058,7 +1138,14 @@ Citing these two authors will show their digraphs and trigraphs:
 
 This option is set to default, but you can --- of course --- deactivate it with |initials=false| in the preamble.
 
+With this default option you don’t have to change anything in your bibliographical-data.
+However  you can switch off the option |initials| and do the abbreviation manually:
 
+\begin{code}
+author = {family=Mann, given=Christian, given-i={Chr}}
+
+author = {family=Hufschmid, given=Thomas, given-i={Th}}
+\end{code}
 
 
 \subsection{Bibliography entry options}\label{options-bibentry}
@@ -1503,7 +1590,7 @@ This following example clarify matters:
 }
 \end{bibexample}
 
-\printbib[10em]{Carter2014}
+\printbib[12em]{Carter2014}
 
 You can also have contributions to a ›Festschrift‹ etc. set up as |@Incollection|,
 but then notice the additional information in |booktitleaddon|.
@@ -1787,17 +1874,17 @@ In the bibliography it will look like
 \printbib{Neils1994}
 
 \item\label{inreference:b} 
-The German Archaeological Institute has a special rule for inreferences in the footnote.
+The \DAI has a special rule for inreferences in the footnote.
 Then the output will be like:\\
 |reference volume (year) pages s.v. title (author)| \\
 and there will be no reference to the bibliography since the entry is fully described in the footnote.
 \DescribeMacro{inreferences} If you prefer this method you have to use the preamble option called  |inreferences|---cf. \cref{inreferences}
 Then it will look like this in the footnote:
-\begin{tcolorbox}[examplebox] 
+\begin{examplebox}
 |\footnote{\cite{Neils1994}.}|
 \tcblower
 \footnote{LIMC 7.1 (1994) 922--951 s. v. Theseus (J. Neils).}
-\end{tcolorbox}
+\end{examplebox}
 When you have the \oarg{postnote} filled out in a citation which belongs to an |@Inreference| then it won’t be printed in the end of the citation.
 The |postnote| \oarg{930 Nr. 283} will be printed instead of the |pages|:
 \begin{example}
@@ -2163,7 +2250,7 @@ urn = *@\marg{urn:xxx}@*
 \end{code}  
 
 \DescribeMacro{zenon}
-This eprint-form is especially designed for the OPAC (Online Public Access Catalogue) of the German Archaeological Institute.
+This eprint-form is especially designed for the OPAC (Online Public Access Catalogue) of the \DAI.
 All bibliographical entries in this OPAC can be referred to via this link.
 You only need to insert the individual Zenon-number of the entry, e.\,g. \emph{http://zenon.dainst.org/Record/001371402} where \emph{001371402} is the individual number---cf. \cref{Zanker2009}.
 
@@ -2494,7 +2581,7 @@ In these examples we used such |@String|:
 \item[YUP] Yale University Press
 \end{description}
 \end{multicols}
-\section{List of abbreviation according to the German Archaeological Institute-guidelines}\label{abbrv-lists}
+\section{List of abbreviation according to the \DAI-guidelines}\label{abbrv-lists}
 We modified the lists with abbreviations of journals, corpora, etc. to make them usable with |bib|\LaTeX.
 Below there are two lists with\DescribeMacro{@String} |@String| (in \textbf{bold} letters on the left), 
 one with the abbreviations (\cref{liste-kurz}), the other with the long forms  (\cref{liste-lang}).