From 02193cc5ca03abf234d3bc9d77b4821d85f58c62 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Fri, 28 Feb 2020 03:02:25 +0000 Subject: CTAN sync 202002280302 --- macros/latex/contrib/nameauth/nameauth.dtx | 31 +++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) (limited to 'macros/latex/contrib/nameauth/nameauth.dtx') diff --git a/macros/latex/contrib/nameauth/nameauth.dtx b/macros/latex/contrib/nameauth/nameauth.dtx index 7efca1df6c..b523a08777 100644 --- a/macros/latex/contrib/nameauth/nameauth.dtx +++ b/macros/latex/contrib/nameauth/nameauth.dtx @@ -207,7 +207,7 @@ the README.txt or README for more information. %\NeedsTeXFormat{LaTeX2e}[1999/12/01] %\ProvidesPackage{nameauth} %<*package> - [2020/02/20 3.3 Name authority mechanism for consistency in text and index] + [2020/02/26 3.4 Name authority mechanism for consistency in text and index] % %<*driver> \documentclass[11pt]{ltxdoc} @@ -269,7 +269,7 @@ the README.txt or README for more information. %^^A Set up initial page layout to fit both letter and DIN A4. \usepackage[textwidth=137mm,textheight=237mm,right=25mm,marginparwidth=40mm,nohead]{geometry} %^^A Include only this version of the package. -\usepackage{\jobname}[2020/02/20] +\usepackage{\jobname}[2020/02/26] %^^A Set up all tabular information. \usepackage{booktabs} \usepackage{colortbl} @@ -589,6 +589,7 @@ the README.txt or README for more information. % \changes{2.0}{2015/11/11}{Use dtxgen; prevent bad args} % \changes{2.5}{2016/04/06}{No default format} % \changes{3.3}{2020/02/20}{Update manual} +% \changes{3.4}{2020/02/26}{Update manual, \texttt{examples.tex}} % % \GetFileInfo{\jobname.dtx} % @@ -619,7 +620,7 @@ the README.txt or README for more information. % \fi % \fi % \fi -% +% % \ClearNum % \ifDoTikZ % \tcbset{fonttitle=\bfseries\sffamily,box align=top,lower separated=false} @@ -2207,12 +2208,12 @@ the README.txt or README for more information. % \end{tabular} % \end{quote} % -% The Roman naming\Info{Roman names} system does present some challenges. As long as we do not use \cmd{\CapThis}, we do not need alternate formatting (Section~\ref{sec:AltFormat}). Earlier we treated \LCicero[Marcus Tullius] as a Western name. Now we handle Roman names more properly. +% The Roman naming\Info{Roman names} system does present some challenges. As long as we do not use \cmd{\CapThis}, we do not need alternate formatting (Section~\ref{sec:AltFormat}). Earlier we treated \LCicero[Marcus Tullius] as a Western name. Now we show how to handle Roman names more properly. % -% We have a \textit{praenomen}, a personal name. Then we have a \textit{nomen}, a clan name. Finally, we would have a \textit{cognomen}, a nickname, except it became hereditary to denote clan branches. Added to that are \textit{agnomina}, affixed names. +% Roman names have a \textit{praenomen}, a personal name, then a \textit{nomen}, a clan name, followed by a \textit{cognomen}, a ``nickname,'' except it could be inherited from one's father to denote clan branches. Added to that are \textit{agnomina}, affixed names. % % Popular\Info{popular works} sources tend to treat the \textit{cognomen} as we might a surname, with the indexed form: \ShowIdxPageref*[\meta{praenomen} \meta{nomen}]{\meta{cognomen} \meta{agnomen}}.\footnote{See Geiss, \textit{Geschichte Griffbereit}; Kinder and Hilgemann, \textit{dtv-Atlas zur Weltgeschichte}, 2 vols., 29th printing (1964; Munich: Deutscher Taschenbuch Verlag, 1993). For further resources see: \url{http://books.infotoday.com/books/Indexing-names.shtml}. See also \url{https://en.wikipedia.org/wiki/Roman_naming_conventions}.} -% We want all names in the index, so we define macros in \meta{FNN} and \meta{SNN} that expand one or two components: \textit{praenomen} and \textit{nomen}, \textit{cognomen} and \textit{agnomen}. We begin by defining a name with macros using \cmd{\noexpand} to prevent error: +% We want all names in the index, so we define macros in \meta{FNN} and \meta{SNN} that expand to become one or two components: \textit{praenomen} and \textit{nomen}; \textit{cognomen} and \textit{agnomen}. We begin by defining a name with macros using \cmd{\noexpand} to prevent error: %\newif\ifSkipGens %\newif\ifNoGens %\newif\ifSkipAgnomen @@ -2268,7 +2269,7 @@ the README.txt or README for more information. % The\Info{scholarly works} \textit{Oxford Classical Dictionary} and other scholarly sources index under the \textit{nomen}. That requires a similar approach, but it moves the \textit{nomen} from \meta{FNN} to \meta{SNN}. Although we will not index the name, we will show how to set up \SkipGenstrue\Scipio\ to work in that alternate configuration. % \newpage % -% We keep the Boolean flags as previously created. We redefine the name in the following manner: +% We keep the Boolean flags and formatting hooks from above. We redefine the name in the following manner: % \begin{quote}\small % \StartNum % \begin{verbatim} @@ -3444,7 +3445,7 @@ the README.txt or README for more information. % \bfseries Defaults & \bfseries Name Length & \bfseries Format Hooks & \bfseries Test Path\\\midrule % \bfseries Pre-First Use & Long & First & False\\ % \rowcolor{black!7!white}\bfseries Subsequent Use\quad\hbox{} & Long or short & Subsequent & True\\\bottomrule -% \end{tabular}\bigskip\\ +% \end{tabular}\medskip\\ % % \begin{tabular}{lll}\toprule % \bfseries Modifications & \bfseries Form & \bfseries Function\\\midrule @@ -3460,18 +3461,18 @@ the README.txt or README for more information. % \end{center} % % \DescribeMacro{\ForgetName} -% This macro takes the same arguments as \cmd{\Name}. It ``forgets'' a name, forcing a ``pre-first use'' case. The syntax is: -% \begin{quote}\small -% \cmd{\ForgetName}\oarg{FNN}\marg{SNN|,| Affix}\oarg{Alternate} +% This macro takes the same arguments as \cmd{\Name}. It ``forgets'' a name, forcing a ``pre-first use'' state that will trigger a first-time name use: +% \begin{quote} +% \fbox{\mystrut\ \cmd{\ForgetName}\oarg{FNN}\marg{SNN|,| Affix}\oarg{Alternate}\ } % \end{quote} % % \DescribeMacro{\ForgetThis} % This prefix macro causes the next instance of a naming macro or shorthand to ``forget'' a name before printing it.\Version{3.1} After knowing |\Einstein| ``\Einstein'' we forget him and again have a first reference: |\ForgetThis\Einstein| ``\ForgetThis\Einstein.''\medskip % % \DescribeMacro{\SubvertName} -% This macro takes the same arguments as \cmd{\Name}. It ``subverts'' a name, forcing a ``subsequent use'' case. The syntax is: +% This macro takes the same arguments as \cmd{\Name}. It ``subverts'' a name, creating a name pattern control sequence and forcing a ``subsequent use'' case: % \begin{quote}\small -% \cmd{\SubvertName}\oarg{FNN}\marg{SNN|,| Affix}\oarg{Alternate} +% \fbox{\mystrut\ \cmd{\SubvertName}\oarg{FNN}\marg{SNN|,| Affix}\oarg{Alternate}\ } % \end{quote} % % \DescribeMacro{\SubvertThis} @@ -3785,8 +3786,8 @@ the README.txt or README for more information. % These convenience macros (an early feature) print a main name and a cross-reference in parentheses: % \DescribeMacro{\PName*} % \begin{quote}\small -% \fbox{\vbox{\hbox{\mystrut\cmd{\PName\ }\oarg{FNN}\marg{SAFX}\oarg{xref\,FNN}\marg{xref\,SAFX}\oarg{xref\,Alternate}}\par -% \hbox{\mystrut\cmd{\PName*}\oarg{FNN}\marg{SAFX}\oarg{xref\,FNN}\marg{xref\,SAFX}\oarg{xref\,Alternate}}}} +% \fbox{\vbox{\hbox{\mystrut\ \cmd{\PName\ }\oarg{FNN}\marg{SAFX}\oarg{xref\,FNN}\marg{xref\,SAFX}\oarg{xref\,Alternate}\ }\par +% \hbox{\mystrut\ \cmd{\PName*}\oarg{FNN}\marg{SAFX}\oarg{xref\,FNN}\marg{xref\,SAFX}\oarg{xref\,Alternate}\ }}} % \end{quote} % The starred form \cmd{\PName*} is like the starred form \cmd{\Name*} to the extent that it prints a long form of \meta{FNN}\meta{SAFX}. It does not affect the cross-reference arguments \meta{xref FNN}\meta{xref SAFX}\meta{xref Alternate}. % -- cgit v1.2.3