summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nameauth
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-11-30 23:01:38 +0000
committerKarl Berry <karl@freefriends.org>2015-11-30 23:01:38 +0000
commit95f2a6a20bef7c3ef889f9f3c06927f3d5c70a74 (patch)
tree789f8fa6bcb4558742417e355f3f72a25f037145 /Master/texmf-dist/source/latex/nameauth
parent92a3670e2756790a48c372626853cb511e8dcc40 (diff)
nameauth (30nov15)
git-svn-id: svn://tug.org/texlive/trunk@38983 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/nameauth')
-rw-r--r--Master/texmf-dist/source/latex/nameauth/nameauth.dtx24
1 files changed, 12 insertions, 12 deletions
diff --git a/Master/texmf-dist/source/latex/nameauth/nameauth.dtx b/Master/texmf-dist/source/latex/nameauth/nameauth.dtx
index b3def071436..2346ea5313b 100644
--- a/Master/texmf-dist/source/latex/nameauth/nameauth.dtx
+++ b/Master/texmf-dist/source/latex/nameauth/nameauth.dtx
@@ -168,7 +168,7 @@ Running "make install" installs the files in the local TeX tree.
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{nameauth}
%<*package>
- [2015/11/24 v2.1 Name authority mechanism for consistency in text and index]
+ [2015/11/29 v2.11 Name authority mechanism for consistency in text and index]
%</package>
%<*driver>
\documentclass[11pt]{ltxdoc}
@@ -372,7 +372,7 @@ Running "make install" installs the files in the local TeX tree.
% \changes{v2.1}{2015/11/24}{Isolate Unicode issues}
% \GetFileInfo{\jobname.dtx}
% \DoNotIndex{\@empty, \@gobble, \@period, \@token, \trim@spaces, \zap@space}
-% \DoNotIndex{\begingroup, \bfseries, \bgroup, \csdef, \csgdef, \csgdef, \csname, \csundef, \DeclareOption, \def, \detokenize, \edef, \egroup, \else, \endcsname, \endgroup, \endinput, \ExecuteOptions, \expandafter, \fi, \foo, \futurelet, \global, \hbox, \if, \ifcsname, \ifx, \ignorespaces, \index, \itshape, \leavevmode, \let, \newcommand, \newcommandx, \newenvironment, \newif, \nobreakspace, \PackageError, \PackageWarning, \ProcessOptions, \relax, \renewcommand, \RequirePackage, \scshape, \space, \textbackslash, \uppercase}
+% \DoNotIndex{\begingroup, \bfseries, \bgroup, \csdef, \csgdef, \csname, \csundef, \DeclareOption, \def, \detokenize, \edef, \egroup, \else, \endcsname, \endgroup, \endinput, \ExecuteOptions, \expandafter, \fi, \futurelet, \global, \hbox, \if, \ifcsname, \ifx, \ignorespaces, \index, \itshape, \leavevmode, \let, \newcommand, \newcommandx, \newenvironment, \newif, \nobreakspace, \PackageError, \PackageWarning, \ProcessOptions, \relax, \renewcommand, \RequirePackage, \scshape, \space, \textbackslash, \uppercase}
%
%\title{\textsf{nameauth} --- Name authority mechanism for consistency in text and index\thanks{This file
% describes version \fileversion, last revised \filedate.}
@@ -798,7 +798,7 @@ Running "make install" installs the files in the local TeX tree.
% |\end{nameauth}|
% \end{quote}
%
-% Please bear in mind that |\<| in this context is a control sequence. If you forget it or miss the backslash you will get errors. Leading and trailing spaces in each |&|-delimited field are stripped, as is also the case in the main interface. There \emph{must} be four argument fields (three ampersands) per line.
+% Please bear in mind that |\<| in this context is a control sequence. If you forget it or just use |<| without the backslash you will get errors. Leading and trailing spaces in each |&|-delimited field are stripped, as is also the case in the main interface. There \emph{must} be four argument fields (three ampersands) per line.
%
% Each \meta{cseq} creates three macros. In the document text, |\|\meta{cseq} itself calls \cmd{\Name}. |\L|\meta{cseq} (think ``Long'') calls \cmd{\Name*}. |\S|\meta{cseq} (think ``Short'') calls \cmd{\FName}. In the document text, as with \cmd{\Name}, include trailing braces |{|\,|}| if text in brackets |[|\,|]| follows any of the shorthands.
%
@@ -863,7 +863,7 @@ Running "make install" installs the files in the local TeX tree.
% |\Yamt|\hfill \Yamt
% \end{multicols}
%
-% In this manual we use a dagger (\dag) to indicate all Eastern names with Western forms in the index. The use is encouraged to compare the index entries with the body text in order to understand better what the macros are doing.\clearpage
+% In this manual we use a dagger (\dag) to indicate all Eastern names with Western forms in the index. The user is encouraged to compare the index entries with the body text in order to understand better what the macros are doing.\clearpage
%
% \subsubsection{Older Syntax}
% \label{sec:obsolete}
@@ -1188,6 +1188,7 @@ Running "make install" installs the files in the local TeX tree.
% \NamesActive
%
% \subsubsection{Naming Standards}
+% \label{sec:standards}
%
% According to the \emph{Chicago Manual of Style}, English names with the particles \emph{de}, \emph{de\ la}, \emph{d'}, \emph{von}, \emph{van}, and \emph{ten} generally keep them with the last name, using varied capitalization. \emph{Le}, \emph{La}, and \emph{L'} always are capitalized unless preceded by \emph{de}.
%
@@ -1195,7 +1196,7 @@ Running "make install" installs the files in the local TeX tree.
% In English, these particles go in the \meta{SNN} field of \cmd{\Name}, \emph{e.g.}, \ForgetName[Walter]{de la Mare}\Name[Walter]{de la Mare}. To capitalize \emph{de} when it arises at the beginning of a sentence, use |\CapThis\Name[Walter]{de la Mare}|. \CapThis\Name[Walter]{de la Mare} will think it fair. In the rare case where the particle is but one character (unlike all those listed above), the capping macros will eat the space between particle and name. One workaround is to follow such a particle with \cmd{\nobreakspace}.
%
% \DescribeMacro{\AccentCapThis}
-% Using \texttt{xelatex} and \texttt{lualatex} present no problems for \cmd{\CapThis} when the first character in the \meta{SNN} field is an extended Unicode character. However, using \texttt{pdflatex} and \textsf{inputenc} will cause \cmd{\CapThis} to fail and halt execution; see Section~\ref{sec:accents}. In this particular case you can use \cmd{\AccentCapThis} instead. Alternately, you could \cmd{\CapThis} but you would have to put the leading character in braces or use a control sequence.
+% \cmd{\CapThis} works in all cases under \texttt{xelatex} and \texttt{lualatex}. Using \texttt{pdflatex} causes \cmd{\CapThis} to fail and halt execution only when the initial character in \meta{SNN} is an extended Unicode character; see Section~\ref{sec:accents}. In this special and infrequent case, either substitute \cmd{\AccentCapThis}, or put the extended character in braces, or use control sequences.
%
% Non-English contexts do not always bind particles to surnames. Using \cmd{\Name} and \cmd{\FName} with alternate forenames helps address this. See also Section~\ref{sec:Particles}.
%
@@ -1246,8 +1247,8 @@ Running "make install" installs the files in the local TeX tree.
% \subsubsection{Accented Names}
% \label{sec:accents}
%
-% For texts that contain accented characters, using \texttt{xelatex} or \texttt{lualatex} with \texttt{xindy} (\texttt{texindy}) is recommended. Since version 2.1, \textsf{nameauth} generally does not require any special treatment for the leading character of the \meta{SNN} field. The only exception is the case where you need \cmd{\CapThis} and \cmd{\AccentCapThis}.\footnote{The root of this problem is shown by this example: \texttt{\textbackslash def\textbackslash foo\#1\#2\#3\textbackslash relax\{<\#1\#2><\#3>\}.}\def\foo#1#2#3\relax{<#1#2><#3>} With \texttt{\textbackslash foo abc\textbackslash relax} you get \foo abc\relax. With \texttt{\textbackslash foo æbc\textbackslash relax} you get \foo æbc\relax. A Unicode-native engine always gives you the results <ab><c> and <æb><c>.\\[0.5ex]
-%\indent Using \texttt{xelatex} and \texttt{lualatex} avoids the problem. With \texttt{pdflatex}, if you try to capitalize half of ``æ'' you will get \texttt{Argument of \textbackslash UTFviii@two@ octets has an extra \}.} Because \textsf{nameauth} passes on the capitalized word to other macros via \cmd{\protected@edef} instead of just printing it in the text, many extant word-capitalizing macros and even kernel macros like \cmd{\in@}\dots\cmd{\ifin@} fail with regard to expansion, scoping, and control sequence definition.}
+% For texts that contain accented characters, using \texttt{xelatex} or \texttt{lualatex} with \texttt{xindy} (\texttt{texindy}) is recommended. Since version 2.1, \textsf{nameauth} generally does not require any special treatment for the leading character of the \meta{SNN} field. The only exception is when you need to use \cmd{\CapThis} under \texttt{pdflatex}. That is the case where you substitute \cmd{\AccentCapThis} (Section~\ref{sec:standards}).\footnote{The root of this problem is shown by this example: \texttt{\textbackslash def\textbackslash foo\#1\#2\#3\textbackslash relax\{<\#1\#2><\#3>\}.} With \texttt{\textbackslash foo abc\textbackslash relax} you get <ab><c>. With \texttt{\textbackslash foo æbc\textbackslash relax} you get <æ><bc>.\\[0.5ex]
+%\indent Using \texttt{xelatex} and \texttt{lualatex} always gives you <ab><c> and <æb><c>, thus avoiding the problem. Using \texttt{pdflatex} with \cmd{\CapThis} yields \texttt{Argument of \textbackslash UTFviii@two@ octets has an extra \}.} Many extant word-capitalizing macros and even kernel macros like \cmd{\in@}\dots\cmd{\ifin@} cause errors when used as we do in \textsf{nameauth}.}
%
% Under NFSS and the |utf8| input encoding, the following glyphs generally are available to you:
% \begin{quote}\small
@@ -1280,16 +1281,15 @@ Running "make install" installs the files in the local TeX tree.
% |\Name{Æthelred, II}|\hfill \Name{Æthelred, II}
% \end{quote}
%
-% Additional accents and glyphs can be used with Unicode input, NFSS, \textsf{inputenc}, and \textsf{fontenc} when using fonts with TS1 glyphs, \emph{e.g.}, |\usepackage{lmodern}| (per the table on pages 455--63 in \emph{The Latex Companion}):
+% Additional accents and glyphs can be used with Unicode input, NFSS, \textsf{inputenc}, and \textsf{fontenc} when using fonts with TS1 glyphs, \emph{e.g.}, |\usepackage{lmodern}| (per the table on pages 455--63 in \emph{The Latex Companion}). The example below lets you type, ``In Congreſs, July 4, 1776.''
% \begin{quote}
% |\usepackage{newunicodechar}|\\
% |\DeclareTextSymbolDefault{\textlongs}{TS1}|\\
% |\DeclareTextSymbol{\textlongs}{TS1}{115}|\\
% |\newunicodechar{ſ}{\textlongs}|
% \end{quote}
-% That lets you type ``In Congreſs, July 4, 1776.'' |\newunicodechar{ā}{\=a}| allows |\Name{Ghazāli}| to generate \IndexInactive\Name{Ghaz\=ali}\IndexActive.
%
-% Control sequences like |\=a| fail when using \texttt{makeindex} and \texttt{gind.ist}, such as with the \textsf{ltxdoc} class, because the equal sign is an ``actual'' character instead of |@|. Using |\index{Gh{\=a}zali}| halts execution. Using |\index{Gh\=azali}| gives an ``azali'' entry sorted under ``Gh'' (thanks \Name[Dan]{Luecking}). This issue is not specific to \textsf{nameauth} and affects any document where one uses \texttt{gind.ist}.
+% Additionally, |\newunicodechar{ā}{\=a}| allows |\Name{Ghazāli}| to generate \IndexInactive\Name{Ghaz\=ali}\IndexActive. But be careful! Control sequences like |\=a| fail when using \texttt{makeindex} and \texttt{gind.ist}, such as with the \textsf{ltxdoc} class, because the equal sign is an ``actual'' character instead of |@|. Using |\index{Gh{\=a}zali}| halts execution. Using |\index{Gh\=azali}| gives an ``azali'' entry sorted under ``Gh'' (thanks \Name[Dan]{Luecking}). This issue is not specific to \textsf{nameauth} and affects any document where one uses \texttt{gind.ist}.
%
%One may use expandable control sequences in names (thanks \Name*[Robert]{Schlicht}). Also, you can define letters with \cmd{\edef} and \cmd{\noexpand} to use in names, as some do to ``protect'' accented letters in names. As of version 2.0 of \textsf{nameauth} helpful concerns expressed by \Name[Patrick]{Cousot} have been addressed.
%
@@ -3470,6 +3470,7 @@ Running "make install" installs the files in the local TeX tree.
% \begin{environment}{nameauth}
% \changes{v1.6}{2013/03/10}{Added}
% \changes{v2.0}{2015/11/11}{Redesigned argument handling}
+% \changes{v2.11}{2015/11/29}{Bugfix}
% The |nameauth| environment provides a means to implement shorthand references to names in a document.
% \begin{macrocode}
\newenvironment{nameauth}{%
@@ -3500,7 +3501,7 @@ Running "make install" installs the files in the local TeX tree.
\fi
\ifx\testd\@empty
\ifx\testb\@empty
- \ex\csxdef\ex{\ex\arga\ex}\ex{\ex\Name\ex{\the\tokc}}%
+ \ex\csgdef\ex{\ex\arga\ex}\ex{\ex\Name\ex{\the\tokc}}%
\ex\csgdef\ex{\ex L\ex\arga\ex}\ex{\ex\Name\ex*\ex{\the\tokc}}%
\ex\csgdef\ex{\ex S\ex\arga\ex}\ex{\ex\FName\ex{\the\tokc}}%
\else
@@ -3552,7 +3553,6 @@ Running "make install" installs the files in the local TeX tree.
}{\endgroup\ignorespaces}
% \end{macrocode}
% \end{environment}
-%
%\Finale
\endinput
%</package>