summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2025-02-06 20:42:16 +0000
committerKarl Berry <karl@freefriends.org>2025-02-06 20:42:16 +0000
commit3ca74a4dcadead8391e1c5948ca23a35ed404be7 (patch)
tree56c374786cc5be153cce0d26849db90ea4c49c05 /Master/texmf-dist/doc
parenta1f2fdff91defe5e51e1e2f520db04baf6a4c37e (diff)
nameauth (6feb25)
git-svn-id: svn://tug.org/texlive/trunk@73749 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/README.md468
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/beamer01.pdfbin68498 -> 68526 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/beamer02.pdfbin68500 -> 68527 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/beamer03.pdfbin68492 -> 68521 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/cat01.pdfbin88992 -> 90561 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/compat.tex137
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/examples.tex942
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/nameauth.pdfbin1621233 -> 1672025 bytes
8 files changed, 891 insertions, 656 deletions
diff --git a/Master/texmf-dist/doc/latex/nameauth/README.md b/Master/texmf-dist/doc/latex/nameauth/README.md
index dbcf3b3971f..d6c4d3acf6e 100644
--- a/Master/texmf-dist/doc/latex/nameauth/README.md
+++ b/Master/texmf-dist/doc/latex/nameauth/README.md
@@ -1,254 +1,225 @@
-# 1. Short Description
+# 1 Short Description
The `nameauth` package automates the correct formatting and indexing of names for professional writing. This aids the use of a name authority and the editing process without needing to retype name instances.
-# 2. Files in Zip Archive
+# 2 Installing a Distro Package
-The following files are included in the archive that is uploaded to CTAN:
+One can find `nameauth` in one's current TeX distribution. See the appropriate documentation in TeXlive, MikTeX, MacTeX, Linux distro, BSD, etc. Use those tools to ensure that `nameauth` is installed. **You are done.**
+
+# 3 Obtaining from CTAN
+
+## 3.1 Getting the Package Archive
+
+If not using the tools above, one can download `nameauth.zip` from [CTAN](https://mirrors.ctan.org/macros/latex/contrib/nameauth.zip). After downloading, unpack `nameauth.zip` in an appropriate directory. Change to the directory containing the supplied files. The following files are included in the archive that is uploaded to CTAN:
| Filename | Description |
| :------------- | :------------------------- |
+| *Source* | |
| `Makefile` | for use with GNU make |
| `cat01.pdf` | manual illustration, ch. 7 |
| `beamer01.pdf` | manual illustration, ch. 9 |
| `beamer02.pdf` | manual illustration, ch. 9 |
| `beamer03.pdf` | manual illustration, ch. 9 |
| `nameauth.dtx` | commented macro file |
+| *Generated* | |
| `compat.tex` | compatibility module |
| `examples.tex` | example file |
-| `nameauth.pdf` | package documentation |
| `README.md` | this file |
+| *Built* | |
+| `nameauth.pdf` | package documentation |
-# 3. Installing a Distro Package
+## 3.2 Determining the Installation type
-One can find `nameauth` in one's current TeX distribution. See the appropriate documentation in TeXlive, MikTeX, MacTeX, Linux distro, BSD, etc. Use those tools to ensure that `nameauth` is installed. You are done.
+### 3.2.1 Read `Makefile` First
-# 4. Installing from CTAN
+`Makefile` has an extensive comment on usage, as well as other helpful comments. It lists all required programs needed to use the GNU make file for installation in a POSIX-compliant environment, such as GNU/Linux, various BSDs, MacOS, and WSL or Cygwin on Windows.
-## 4.1 Getting the Package Archive
+Minimum required programs include `bash` or an equivalent shell (for which one must edit `Makefile`), and `make`, plus a TeX distribution. To distribute the package, one also requires at least `sed`, and `zip`.
-If not using the tools above, one can download `nameauth.zip` from [CTAN](https://mirrors.ctan.org/macros/latex/contrib/nameauth.zip). After downloading, unpack `nameauth.zip` in an appropriate directory. Change to the directory containing the supplied files.
+### 3.2.2 POSIX Cases
-## 4.2 Using GNU make
+If one is using a TeX distribution in a POSIX environment (MacOS, Linux distro, BSD, etc.) and has the required programs listed in `Makefile`, one may do one of the following:
-### 4.2.1 Read the File
+1. Use GNU make to build and install. **Section 4.1**
-**Please inspect the included `Makefile` before using it.**
+2. Build and install manually. **Section 4.2**
-`Makefile` has an extensive comment on usage, as well as many other comments. This file lists all the programs that must be installed in order to use the GNU make file, helping one to check for prerequisites and dependencies. This method is designed for a POSIX-compliant environment, such as GNU/Linux, various BSDs, MacOS, and WSL or Cygwin on Windows.
+### 3.2.3 Windows Cases
-### 4.2.2 Prepare to Install, No Building
+Windows offers the largest number of possibilities:
-One does not need to build `nameauth` completely from source (although it may be a good idea to do a native build). If the provided files are sufficient, one can type:
+* Cygwin offers a POSIX environment and its own TeX distribution. Avoid installing another TeX distro via WSL or Windows native. **Section 4.1**
- make unpack
+* WSL offers a POSIX environment and its own TeX distribution. Avoid installing another TeX distro via Cygwin or Windows native. **Section 4.1**
-This target only unpacks the supplied generated files from `nameauth.dtx`. It does not try to create the documentation. One will have the following files now:
+* Use `make` within either Cygwin or WSL to build this package for native Windows TeX distributions MikTeX or TeXlive. Install needed build components in either Cygwin or WSL, alongside either MikTeX or TeXlive, but not both distros. Avoid installing another TeX distro in either Cygwin or WSL.
-| Filename | Description | TDS-where to |
-| :------------- | :------------------------- | :----------- |
-| `Makefile` | for use with GNU make | source dir |
-| `cat01.pdf` | manual illustration, ch. 7 | source dir |
-| `beamer01.pdf` | manual illustration, ch. 9 | source dir |
-| `beamer02.pdf` | manual illustration, ch. 9 | source dir |
-| `beamer03.pdf` | manual illustration, ch. 9 | source dir |
-| `nameauth.dtx` | commented macro file | source dir |
-| | | |
-| `nameauth.ins` | installation driver | unneeded |
-| | | |
-| `compat.tex` | compatibility module | doc dir |
-| `examples.tex` | example file | doc dir |
-| `nameauth.pdf` | package documentation | doc dir |
-| `README.md` | this file | doc dir |
-| | | |
-| `nameauth.sty` | style file | package dir |
+ * One can use `make` to build this package. **Section 4.1.1**
-Take a look at **4.2.3 Specific Build Cases** and, depending on the use case, skip either to **4.2.5 Installation** (using make) or **4.3.3 Installation Prerequisites** (manual) below.
+ * Installation must be manual. **Section 4.2.2**
-### 4.2.3 Specific Build Cases: Program Extensions
+* Directly using native Windows TeX distributions (MikTeX or TeXlive)
-Windows presents some interesting cases. Both Cygwin and WSL provide POSIX environments that include respective TeX distros of their own. Yet they also will operate with native Windows-based TeX distros like MikTeX and TeXlive.
+ All building and installation must be manual. **Section 4.2**
-When using the TeX distros built in to Cygwin and WSL exclusively, one can treat it basically as a POSIX-compliant environment.
+* Other POSIX environments running under DOS, Windows, and other systems have not been tested and are not supported.
-Even when using Cygwin and a Windows-based TeX distro, one can treat package building as being mostly the same as a POSIX environment if all the prerequisite programs are installed. Installation, however, must be manual.
+* `Makefile` contains tests that will mitigate some issues:
-When one uses WSL with a Windows-based TeX distro, the `Makefile` will test whether an ".exe" extension is needed by the programs used in the building process.
+ * If a `.exe` extension is needed by programs used in the building process, that is detected automatically.
-With both Cygwin and WSL, tests will determine if the standard POSIX method is capable of installing and packaging as intended, or if manual methods are needed.
+ * If `ltxfileinfo` does not exist, the make process will produce a zip file that avoids potential problems in Windows.
-* Make will test if `ltxfileinfo` exists. If not, it will produce a zip file with just the package base name to avoid problems that otherwise could arise in Windows.
+ * If `dvipdf` from Ghostscript is installed, the make process will use that. Otherwise it will fall back to `dvipdfmx`.
-* Make will test if `dvipdf` from Ghostscript is installed and use that. Otherwise it will fall back to `dvipdfmx`.
+ * If `pdfjam` is installed, the make process uses it. Otherwise, it will instruct the user to proceed manually. **Section 6.2.3**
-* Make will test if `pdfjam` is installed, if one needs to remake the manual illustrations. Otherwise, it will advise on how to do that manually.
+ * When installing, the make process will check if the path to the install directory exists. If it does not, it will produce an error message and exit.
-* Make will try to see if the path to the desired install directory exists. If it does not, make will produce an error message and exit. If this happens, which is likely under Windows, please refer to installation of local packages in MikTeX [here](https://docs.miktex.org/manual/localadditions.html#id573803) and [here](https://miktex.org/kb/texmf-roots). Otherwise see the [TeX FAQ](https://www.texfaq.org/FAQ-privinst) and [this page](https://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages).
+ If this error message occurs, which is more likely in Windows, please refer to installation of local packages in MikTeX [here](https://docs.miktex.org/manual/localadditions.html#id573803) and [here](https://miktex.org/kb/texmf-roots). Otherwise see the [TeX FAQ](https://www.texfaq.org/FAQ-privinst) and [this page](https://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages).
-Here is a table showing the feasibility of a few scenarios:
+Here is a table showing the feasibility of a few scenarios. Any case that is not mentioned below has not been tested and is not recommended.
-| Platform | TeX Distro Platform | Make builds pkg/zip | Make installs package |
-| :------- | :------------------ | :----------------------------- | :------------------------------ |
-| POSIX | POSIX | Yes<sup>1</sup> | Yes |
-| Cygwin | Cygwin (packages) | Not tested; likely<sup>1</sup> | Not tested; likely <sup>2</sup> |
-| Cygwin | MikTeX (Windows) | Yes<sup>1, 3</sup> | No;<sup>4</sup> do manually |
-| Cygwin | TeXlive (Windows) | Not tested; likely<sup>1</sup> | Not tested; do manually |
-| Cygwin | Cygwin and Windows | Not tested; not recommended | Not tested; not recommended |
-| WSL | WSL Linux packages | Yes<sup>1</sup> | Yes<sup>5</sup> |
-| WSL | MikTeX (Windows) | Yes<sup>1, 3</sup> | No;<sup>4</sup> do manually |
-| WSL | TeXlive (Windows) | Not tested; likely<sup>1</sup> | Not tested; do manually |
-| WSL | WSL and Windows | Not tested; not recommended | Not tested; not recommended |
-| WSL/Cyg | WSL and Cygwin | Not tested; not recommended | Not tested; not recommended |
-| GNUWin | any (Windows) | Not tested; not recommended | Not tested; not recommended |
+| Build Env. | TeX Distro Platform | Make builds pkg/zip | Make installs package |
+| :--------- | :------------------ | :----------------------------- | :------------------------------ |
+| POSIX | POSIX | Yes<sup>1</sup> | Yes |
+| Cygwin | Cygwin (packages) | Not tested; likely<sup>1</sup> | Not tested; likely <sup>2</sup> |
+| Cygwin | MikTeX (Windows) | Yes<sup>1, 3</sup> | No;<sup>4</sup> do manually |
+| Cygwin | TeXlive (Windows) | Not tested; likely<sup>1</sup> | Not tested; do manually |
+| WSL | WSL Linux packages | Yes<sup>1</sup> | Yes<sup>5</sup> |
+| WSL | MikTeX (Windows) | Yes<sup>1, 3</sup> | No;<sup>4</sup> do manually |
+| WSL | TeXlive (Windows) | Not tested; likely<sup>1</sup> | Not tested; do manually |
-<sup>1</sup> All dependencies must be met. Bear in mind MacOS quirks.
+<sup>1</sup> All dependencies must be met. Bear in mind possible MacOS issues.
<sup>2</sup> Installs only to Cygwin environment; not to Windows environment.
-<sup>3</sup> If one attempts the `make images` target, it is unlikely that `pdfjam` will work; one must create pdf page examples included in the manual by compiling the appropriate test files and extracting the pages using a different app.
+<sup>3</sup> The `make images` target using `pdfjam` likely will not work as desired. **Section 6.2.3 Images**
<sup>4</sup> Neither `ltxfileinfo` nor `kpsewhich` will give useful results; do a manual install.
<sup>5</sup> Installs only to WSL Linux distro environment; not to Windows environment.
-### 4.2.4 Building the Package
+# 4 Building and Installing
-In the directory where the files unpacked from the zip archive are located, type `make`. This will do a fresh build of the package using `pdflatex`.
+Regarding command line options longer than one letter, the programs included with major TeX distributions, except for `pdfjam`, use either single dashes or GNU-style double dashes.
-### 4.2.5 Installation
+Here, for the sake of consistency, we use the GNU convention of single dashes with one-letter options and double dashes for longer options.
-The user must already have a TDS-compliant tree set up in order for installation to work. Thus, one must have created a `texmf` directory to which TEXMFHOME refers, if in a POSIX environment, or have the equivalent in another environment. Currently, `Makefile` only installs into POSIX environments.
+## 4.1 GNU `make` for Building and Installation
-Assuming that one has a use case where one can use GNU make, one can choose the following:
+### 4.1.1 Build
-* Type `make inst` to install the package files in the user's personal TDS-compliant directory tree.
+In the directory where the files unpacked from the zip archive are located, type `make`. This will do a fresh build of the package using `pdflatex`. To add more options, use, e.g.: `make ADDOPTS="--synctex=1"`.
-* Type `make install` to install the package files in the system-wide, local TDS-compliant directory tree. The user will be prompted for the `sudo` password.
+There is a make target, `make unpack`, that does not build the package. It only regenerates files from `nameauth.dtx`.
- If, for some reason, this fails, do a manual install (below).
+### 4.1.2 Install
-Note that these make targets depend on `package`, which does not do a clean build. If one desires a clean build that is followed by an install, use `make release inst` or `make release install`.
+Currently, `Makefile` only installs into POSIX environments.
-### 4.2.6 Removal
+For individual use, one must have a TDS-compliant tree set up in order for installation to work. For more info in setting up those trees, see **Section 4.2.3** for the individual case and **Section 4.2.4** for the site-wide case.
+
+For site-wide use, one must be able to get root privileges via `sudo`.
+
+* Type `make inst` to install the package files in the user's personal TDS-compliant directory tree.
+
+* Type `make install` to install the package files in the site-wide, local TDS-compliant directory tree. The user will be prompted for the `sudo` password.
+
+### 4.1.3 Remove
The same constraints that apply to installation also apply to removal. If one can do the former, one can do the latter.
* Type `make uninst` to remove the package files in the user's personal TDS-compliant directory tree.
-* Type `make uninstall` to remove the package files in the system-wide, local TDS-compliant directory tree. The user will be prompted for the `sudo` password.
+* Type `make uninstall` to remove the package files in the site-wide, local TDS-compliant directory tree. The user will be prompted for the `sudo` password.
- If, for some reason, this fails, do a manual removal (opposite of steps used below).
+The approach of `Makefile` is not to get too aggressive with deletions from the texmf tree, just in case. One may see harmless, extra, empty directories after removal. One can delete them manually.
-The approach of `Makefile` is not to get too aggressive with deletions from the texmf tree, just in case. One may see harmless, extra empty directories after removal.
+## 4.2 Manual Building and Installation
-## 4.3 Manual Method
+Unlike the case with the supplied `Makefile`, which automates adding extensions, in certain cases using Windows TeX distros, one may have to add the ".exe" extension to the programs.
-Unlike when using GNU make, which automates adding extensions, in the case of working with WSL together with native Windows TeX distros, in the command lines below there may be certain cases where one may have to add the ".exe" extension to the programs. Those cases should, however, be few.
+### 4.2.1 Build
-### 4.3.1 Prepare to Install, No Building
+1. Using the unpacked files from the zip archive, we begin by creating the installation driver, unpacking additional files from `nameauth.dtx`, and generating a copy of the documentation without the table of contents and cross-references:
-One does not need to build `nameauth` completely from source (although it may be a good idea to do a native build). If the provided files are sufficient, one can type:
+ pdflatex --shell-escape --recorder --interaction=batchmode nameauth.dtx
- pdftex nameauth.dtx
+ a. We see the following main files:
-This only unpacks the supplied generated files from `nameauth.dtx`. It does not try to create the documentation. One will have the following files now:
+ `Makefile`, `cat01.pdf`, `beamer01.pdf`, `beamer02.pdf`, `beamer03.pdf`, `nameauth.dtx`, `compat.tex`, `examples.tex`, `nameauth.pdf`, `README.md`, `nameauth.ins`, and `nameauth.sty`.
-| Filename | Description | TDS-where to |
-| :------------- | :------------------------- | :----------- |
-| `Makefile` | for use with GNU make | source dir |
-| `cat01.pdf` | manual illustration, ch. 7 | source dir |
-| `beamer01.pdf` | manual illustration, ch. 9 | source dir |
-| `beamer02.pdf` | manual illustration, ch. 9 | source dir |
-| `beamer03.pdf` | manual illustration, ch. 9 | source dir |
-| `nameauth.dtx` | commented macro file | source dir |
-| | | |
-| `nameauth.ins` | installation driver | unneeded |
-| | | |
-| `compat.tex` | compatibility module | doc dir |
-| `examples.tex` | example file | doc dir |
-| `nameauth.pdf` | package documentation | doc dir |
-| `README.md` | this file | doc dir |
-| | | |
-| `nameauth.sty` | style file | package dir |
+ b. We also see the following temporary files:
-One may skip past building to **4.3.3 Installation Prerequisites** below.
+ `nameauth.aux`, `nameauth.fls`, `nameauth.glo`, `nameauth.hd`, `nameauth.idx`, `nameauth.log`, `nameauth.out`, `nameauth.tmp`, and `nameauth.toc`.
-### 4.3.2 Building the Package
+2. Generate the TOC and cross-references within the documentation:
-1. Using the unpacked files from the zip archive, we begin by creating the installation driver, unpacking additional files from `nameauth.dtx`, and generating a copy of the documentation without the table of contents and cross-references:
+ pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+
+3. Generate the index and glossary files using `makeindex`:
- pdflatex --shell-escape --recorder --interaction=batchmode nameauth.dtx
+ makeindex -q -s gglo.ist -o nameauth.gls nameauth.glo
+ makeindex -q -s gind.ist -o nameauth.ind nameauth.idx
- Now we should have the following files:
+ This adds three files: `nameauth.gls`, `nameauth.ilg`, and `nameauth.ind`.
-| Filename | Description |
-| :------------- | :------------------------- |
-| `Makefile` | for use with GNU make |
-| `cat01.pdf` | manual illustration, ch. 7 |
-| `beamer01.pdf` | manual illustration, ch. 9 |
-| `beamer02.pdf` | manual illustration, ch. 9 |
-| `beamer03.pdf` | manual illustration, ch. 9 |
-| `nameauth.dtx` | commented style file |
-| | |
-| `compat.tex` | compatibility module |
-| `examples.tex` | example file |
-| `nameauth.pdf` | package documentation |
-| `README.md` | this file |
-| | |
-| `nameauth.ins` | installation driver |
-| `nameauth.sty` | style file |
+4. Integrate the glossary (list of changes) and index into the documentation. The second run updates the TOC:
+
+ pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+ pdflatex --recorder --interaction=nonstopmode nameauth.dtx
- In addition, we have the following temporary files:
+ The list of files now looks like:
| Filename | Description |
| :------------- | :--------------------------- |
+| `Makefile` | for use with GNU make |
+| `cat01.pdf` | manual illustration, ch. 7 |
+| `beamer01.pdf` | manual illustration, ch. 9 |
+| `beamer02.pdf` | manual illustration, ch. 9 |
+| `beamer03.pdf` | manual illustration, ch. 9 |
+| `nameauth.dtx` | commented style file |
+| | |
+| `compat.tex` | compatibility module |
+| `examples.tex` | example file |
+| `nameauth.pdf` | package documentation |
+| `README.md` | this file |
+| | |
+| `nameauth.ins` | installation driver |
+| `nameauth.sty` | style file |
+| | |
| `nameauth.aux` | auxiliary file |
| `nameauth.fls` | shows files read |
| `nameauth.glo` | raw glossary entries |
-| `nameauth.hd ` | |
+| `nameauth.hd` | |
| `nameauth.idx` | raw index entries |
| `nameauth.log` | log file |
| `nameauth.out` | pdf bookmark/hypertext info |
| `nameauth.tmp` | temp file used with fancyvrb |
| `nameauth.toc` | table of contents info |
+| `manhook.tmp` | snippet with manual's fmt |
+| `nullhook.tmp | snippet with default format |
+| | |
+| `nameauth.gls` | typeset glossary entries |
+| `nameauth.ilg` | `makeindex` log file |
+| `nameauth.ind` | typeset index entries |
-2. Generate the TOC and cross-references within the documentation:
-
- pdflatex --recorder --interaction=nonstopmode nameauth.dtx
-
-3. Generate the index and glossary files using `makeindex`:
-
- makeindex -q -s gglo.ist -o nameauth.gls nameauth.glo
- makeindex -q -s gind.ist -o nameauth.ind nameauth.idx
-
- This adds the following files:
-
-| Filename | Description |
-| :------------- | :----------------------- |
-| `nameauth.gls` | typeset glossary entries |
-| `nameauth.ilg` | `makeindex` log file |
-| `nameauth.ind` | typeset index entries |
-
-4. Integrate the glossary (list of changes) and index into the documentation. The second run updates the TOC:
-
- pdflatex --recorder --interaction=nonstopmode nameauth.dtx
- pdflatex --recorder --interaction=nonstopmode nameauth.dtx
-
-### 4.3.3 Installation Prerequisites
+### 4.2.2 General Install Info
In order to perform manual installation, one should be familiar with the general information at the [TeX FAQ](https://www.texfaq.org/FAQ-installthings).
Different TeX distributions have somewhat different ways to store TDS-compliant configuration and package data. See, for example, for MikTeX [here](https://docs.miktex.org/manual/localadditions.html#id573803) and [here](https://miktex.org/kb/texmf-roots). Otherwise see the [TeX FAQ](https://www.texfaq.org/FAQ-privinst) and [this page](https://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages).
-The instructions below conform generally to a Unix-based system. There are some cases under Windows where this method may not work. For other systems, please consult the appropriate documentation as needed.
+The instructions below conform generally to a Unix-like system. There are some cases under Windows where this method may not work. For other non-POSIX systems, one will have to know the appropriate procedures and documentation as needed for those cases, which are not covered here.
The user must already have a TDS-compliant tree set up in order for installation to work. We assume that one knows how to become superuser, create directories, move files, and the like.
-### 4.3.4 User's Home Directory
+### 4.2.3 Install for a User
-`TEXMFHOME` is a variable that points to the root of a TDS-compliant directory tree available to a user. To get its value on POSIX-compliant systems, use:
+`TEXMFHOME` is an environment (shell) variable that points to the root of a TDS-compliant directory tree available to a user. To get its value on POSIX-compliant systems, use:
- kpsewhich --var-value TEXMFHOME
+* `kpsewhich --var-value TEXMFHOME`
Quite often, `$TEXMFHOME` is equivalent to `$HOME/texmf`. The dollar sign in front of the variable denotes the value of the variable instead of its name. If `$HOME` is `/home/bob`, then `$TEXMFHOME` would be `/home/bob/texmf`. We can understand the following paths to be under this home directory.
@@ -268,13 +239,13 @@ Quite often, `$TEXMFHOME` is equivalent to `$HOME/texmf`. The dollar sign in fro
| | |
| `$TEXMFHOME/tex/latex/nameauth` | `nameauth.sty` |
-Create the directories in the left-hand column, or whatever one needs to do in one's own case. Move or copy the files in the right-hand column to their respective directories in the left-hand column. On older TeX distributions, run `mktexlsr` on `$TEXMFHOME` to complete the install process (current distributions may not need this).
+Create the directories in the left-hand column, or the equivalent. For manual installation, move or copy the files in the right-hand column to their respective directories in the left-hand column. On older TeX distributions, run `mktexlsr` on `$TEXMFHOME` to complete the install process (current distributions may not need this).
-### 4.3.5 System-Wide Directory
+### 4.2.4 Install Site-Wide
-`TEXMFLOCAL` is a variable that points to the root of a TDS-compliant directory tree available to all users on a local site, system-wide installation.To get its value, use:
+`TEXMFLOCAL` is a variable that points to the root of a TDS-compliant directory tree available to all users on a local site, system-wide installation. To get its value, use:
- kpsewhich --var-value TEXMFLOCAL
+* `kpsewhich --var-value TEXMFLOCAL`
See the [TeX FAQ](https://www.texfaq.org/FAQ-what-TDS). We can understand the following paths to be under this local site, system-wide directory:
@@ -294,33 +265,33 @@ See the [TeX FAQ](https://www.texfaq.org/FAQ-what-TDS). We can understand the fo
| | |
| `$TEXMFLOCAL/tex/latex/nameauth` | `nameauth.sty` |
-Create the directories in the left-hand column, or whatever one needs to do in one's own case. Move or copy the files in the right-hand column to their respective directories in the left-hand column. Change file ownership as needed (not so much on Windows). If needed, run `mktexlsr` with the appropriate permissions on `$TEXMFLOCAL` to complete the install process. See also the discussion on [this page](https://tex.stackexchange.com/questions/45231/how-to-install-system-wide-packages-without-requiring-an-ls-r-database-with-tex).
+Create the directories in the left-hand column. For manual installation, move or copy the files in the right-hand column to their respective directories in the left-hand column. Change file ownership as needed. If needed, run `mktexlsr` with the appropriate permissions on `$TEXMFLOCAL` to complete the install process. See also the discussion on [this page](https://tex.stackexchange.com/questions/45231/how-to-install-system-wide-packages-without-requiring-an-ls-r-database-with-tex).
-# 5. More on Package Building
+# 5 More on Package Building
-* `Makefile` has been upgraded to handle more special cases and not to do unexpected or bad things in those cases, especially on Windows.
+* The package and manual build on current and older TeX distributions, being designed with that in mind.
-* The package and manual build on current and older TeX distributions. In a number of examples, some Unicode characters have been replaced with control sequences in order for this compatibility to work, due to how files written out and read back in affects the expansion of active Unicode characters.
+* The documentation is built only with `pdflatex` for the sake of its design elements. The examples and tests can be built with any LaTeX engine.
-* The documentation now builds only with `pdflatex`, but the examples and tests can use any LaTeX engine. This is because several typesetting decisions that are quite helpful for the manual work only with `pdflatex`.
+* This release was tested on Linux (Pop! OS; vanilla TL, both current and 2017) and Windows 10 (MikTeX using shells from both Cygwin and WSL). Using TL 2017, this release was tested on the full manuscript of the published volume, *Breath of God, Yet Work of Man: Scripture, Philosophy, Dialogue, and Conflict*, with Dr. Albert B. Collver III.
-* This release was tested on Linux (Pop! OS; vanilla TL 2023 and 2017) and Windows 10 (MikTeX using shells from both Cygwin and WSL). The tests using TL 2017 include my published book manuscript, *Breath of God, Yet Work of Man: Scripture, Philosophy, Dialogue, and Conflict*, with Dr. Albert B. Collver III.
+* The CTAN release was created with the current vanilla TL on Pop! OS. See also [this page](https://tug.org/texlive/debian.html) for Debian-based systems. For Arch-based systems, the AUR has a package that takes care of dependencies.
-* The CTAN release was created with vanilla TL 2023 on Pop! OS. The most recent `equivs` file was used to meet package equivalences. See also [this page](https://tug.org/texlive/debian.html).
-
-* TeXlive 2023 and TL 2017 are managed on Pop! OS using [tl-switch](https://github.com/ServusCarolus/tl-switch).
+* TeXlive versions are managed on Pop! OS using [tl-switch](https://github.com/ServusCarolus/tl-switch).
* Four pdf files (`cat01.pdf` and `beamer*.pdf`) used in graphic illustrations are created from the output of test files associated with this manual (see below). Normally, the user need not generate them; they are supplied as source files.
-# 6. Examples / Testing
+# 6 Examples / Testing
+
+The file `examples.tex` also includes `compat.tex`; they should be in the same directory when compiled. The examples document should be enough to illustrate various non-trivial features of this package. It includes most of the longer examples in the manual, edited to fit together in a single document. It also includes other material and tests.
-The file `examples.tex`, also includes `compat.tex`; they should be in the same directory when compiled. The examples document should be enough to illustrate various non-trivial features of this package. It includes most of the longer examples in the manual, edited to fit together in a single document. It also includes other material and tests.
+In addition to this file, a special run of `nameauth.dtx` that defines the macro `\NameauthDoTestFiles` will generate many separate test files. They are not included in the package archive by default.
-In addition to this file, a special run of `nameauth.dtx` that defines the macro `\NameauthDoTestFiles` will generate many separate test files. Normally they are written out to `nameauth.tmp` and read in again as verbatim text. They are not included in the package archive by default in order to minimize clutter.
+To test `nameauth`, either test the files right after installing, or create a new testing directory. One then can copy the files from the TDS-compliant source dir and optionally, the documentation directory as well, or unpack the CTAN zip file into the test directory and build the package.
-To test `nameauth`, either test the files right after installing, or create a new testing directory. One can copy the files from the TDS-compliant source dir and optionally, the documentation directory as well, or unpack the CTAN zip file and build the package.
+## 6.1 Using GNU `make`
-## 6.1 GNU make: Examples, Tests, Images
+### 6.1.1 Examples
* Use the default: `make examples`.
@@ -328,144 +299,145 @@ To test `nameauth`, either test the files right after installing, or create a ne
* To create `examples.pdf` with other LaTeX engines, one can do the following:
- make examples ENGINE=xelatex
- make examples ENGINE=lualatex
- make examples ENGINE=dvilualatex
- make examples ENGINE=latex
+ make examples ENGINE=xelatex
+ make examples ENGINE=lualatex
+ make examples ENGINE=dvilualatex
+ make examples ENGINE=latex
-* To generate additional test files, type `make tests`.
+* To add more options, use, e.g.:
- This will produce many test files numbered by chapter and example within that chapter from the `nameauth.dtx` file. By default it will compile all of the test files using `pdflatex`.
+ make examples ADDOPTS="--synctex=1"
-* If one wants to change engines and re-test the files, type `make testclean`.
+### 6.1.2 Tests
-* One can add the value of ENGINE:
+This will produce many test files numbered by chapter and example within that chapter from the `nameauth.dtx` file. By default it will compile all of the test files using `pdflatex`.
- make tests ENGINE=xelatex
- make tests ENGINE=lualatex
- make tests ENGINE=dvilualatex
- make tests ENGINE=latex
+* To generate test files, type `make tests`.
-* If, for some reason, one wanted to make the manual illustrations (usually not required), one would type `make images`.
+* If one wants to change engines and re-test the files, type `make testclean`.
-## 6.2 Manual Method
+* One can add the value of ENGINE:
-### 6.2.1 Examples
+ make tests ENGINE=xelatex
+ make tests ENGINE=lualatex
+ make tests ENGINE=dvilualatex
+ make tests ENGINE=latex
-Compile `examples.tex`. In the following command lines, one may substitute `latex`, `xelatex`, `lualatex`, and `dvilualatex` for `pdflatex`.
+* To add more options, use, e.g.:
- pdflatex --interaction=nonstopmode examples
- pdflatex --interaction=nonstopmode examples
- makeindex -o examples.ind examples.idx
+ make tests ADDOPTS="--synctex=1"
-This next line is needed because the `index` package makes an index of persons.
+### 6.1.3 Manual Illustrations
- makeindex -o examples.rnd examples.rdx
+Four manual illustrations are based on included tests. If, for some reason, one wanted to create those illustrations (usually not required), one would type `make images`.
-These lines complete the indexes and TOC.
+## 6.2 Manual Method
- pdflatex --interaction=nonstopmode examples
- pdflatex --interaction=nonstopmode examples
+### 6.2.1 Examples
-Another step is used only with `latex` and `dvilualatex`. We default to `dvipdfmx` in case Ghostscript is not installed. If Ghostscript is already installed, one can use `dvipdf` instead. If a file `examples.out.ps` exists, one may delete it after creating the pdf file.
+* Compile `examples.tex`.
- dvipdfmx examples
+ In the following command lines, one may substitute `latex`, `xelatex`, `lualatex`, and `dvilualatex` for `pdflatex`.
-If one changes LaTeX engines, one first must remove all of the auxiliary files.
+ pdflatex --interaction=nonstopmode examples
+ pdflatex --interaction=nonstopmode examples
+ makeindex -o examples.ind examples.idx
-### 6.2.2 Tests
+* This next line is needed because the `index` package makes an index of persons.
-Generate the test files in the following manner from the `dtx`:
+ makeindex -o examples.rnd examples.rdx
- pdflatex "\def\NameauthDoTestFiles{}\input{nameauth.dtx}"
+* These lines complete the indexes and TOC.
-Compile the test files. In the following command lines, one may substitute `latex`, `xelatex`, `lualatex`, and `dvilualatex` for `pdflatex`. One must change the root or base file name for each test file.
+ pdflatex --interaction=nonstopmode examples
+ pdflatex --interaction=nonstopmode examples
- pdflatex --interaction=nonstopmode test01-01
- pdflatex --interaction=nonstopmode test01-01
- makeindex -o test01-01.ind test01-01.idx
+* Another step is used only with `latex` and `dvilualatex`.
-This next line is needed only for `test07-01.tex` because the `index` package is used for an index of persons.
+ We default to `dvipdfmx` in case Ghostscript is not installed. If Ghostscript is already installed, one can use `dvipdf` instead. If a file `examples.out.ps` exists, one may delete it after creating the pdf file.
- makeindex -o test07-01.rnd test07-01.rdx
+ dvipdfmx examples
-These lines complete the indexes and TOC.
+If one changes LaTeX engines, one first must remove all of the auxiliary files.
- pdflatex --interaction=nonstopmode test01-01
- pdflatex --interaction=nonstopmode test01-01
+### 6.2.2 Tests
-This step is used only when using `latex` and `dvilualatex`.
+* Generate the test files in the following manner from the `dtx`:
- dvipdfmx test01-01
+ pdflatex "\def\NameauthDoTestFiles{}\input{nameauth.dtx}"
-If one changes LaTeX engines, one first must remove all of the auxiliary files.
+* Compile the test files.
-### 6.2.3 Images
+ In the following command lines, one may substitute `latex`, `xelatex`, `lualatex`, and `dvilualatex` for `pdflatex`. One must change the root or base file name for each test file.
-If, for some reason, one wants to make the manual illustrations (usually not required), this would be the default procedure:
+ pdflatex --interaction=nonstopmode test01-01
+ pdflatex --interaction=nonstopmode test01-01
+ makeindex -o test01-01.ind test01-01.idx
-Generate the test files in the following manner from the `dtx`:
+* This next line is needed only for `test07-01.tex` because the `index` package is used for an index of persons.
- pdflatex "\def\NameauthDoTestFiles{}\input{nameauth.dtx}"
+ makeindex -o test07-01.rnd test07-01.rdx
-Compile the test files:
+* These lines complete the indexes and TOC.
- pdflatex --interaction=nonstopmode test07-02
- pdflatex --interaction=nonstopmode test07-02
- makeindex -o test07-02.ind test07-02.idx
- pdflatex --interaction=nonstopmode test07-02
- pdflatex --interaction=nonstopmode test07-02
+ pdflatex --interaction=nonstopmode test01-01
+ pdflatex --interaction=nonstopmode test01-01
- pdflatex --interaction=nonstopmode test09-01
- pdflatex --interaction=nonstopmode test09-01
- makeindex -o test09-01.ind test09-01.idx
- pdflatex --interaction=nonstopmode test09-01
- pdflatex --interaction=nonstopmode test09-01
+* This step is used only when using `latex` and `dvilualatex`.
- pdfjam --paper a6paper --landscape --quiet test07_02.pdf 3 --outfile cat01.pdf
- pdfjam --paper a5paper --landscape --quiet test09_01.pdf 1 --outfile beamer01.pdf
- pdfjam --paper a5paper --landscape --quiet test09_01.pdf 2 --outfile beamer02.pdf
- pdfjam --paper a5paper --landscape --quiet test09_01.pdf 3 --outfile beamer03.pdf
+ dvipdfmx test01-01
-# 7. Additional Notes
+If one changes LaTeX engines, one first must remove all of the auxiliary files.
-Version 4.0 switches from `xargs` and `suffix` to `xparse`. Should any modifications still require `xargs` and `suffix`, one can use the `oldargs` package option.
-Improvements in version 4.0 include:
+### 6.2.3 Images
-* Change to `xparse`, which increases power and flexibility going forward.
+Four manual illustrations are based on included tests. If, for some reason, one wanted to make the manual illustrations (usually not required), this would be the default procedure:
-* Further changes to the manual that make it more readable and consistent.
+* Generate the test files in the following manner from the `dtx`:
-Version 3.7 remains here: [style](https://www.tug.org/svn/texlive/branches/branch2022.final/Master/texmf-dist/tex/latex/nameauth/), [docs](https://www.tug.org/svn/texlive/branches/branch2022.final/Master/texmf-dist/doc/latex/nameauth/), and [source](https://www.tug.org/svn/texlive/branches/branch2022.final/Master/texmf-dist/source/latex/nameauth/).
+ pdflatex "\def\NameauthDoTestFiles{}\input{nameauth.dtx}"
-Improvements in version 3.7 include:
+* Compile the test files:
-* Rejection of stale assumptions that had built up over time, based either on initial ignorance or on features that have since changed in LaTeX.
+ pdflatex --interaction=nonstopmode test07-02
+ pdflatex --interaction=nonstopmode test07-02
+ makeindex -o test07-02.ind test07-02.idx
+ pdflatex --interaction=nonstopmode test07-02
+ pdflatex --interaction=nonstopmode test07-02
-* The examples file contains some tests that used to be in the documentation.
+ pdflatex --interaction=nonstopmode test09-01
+ pdflatex --interaction=nonstopmode test09-01
+ makeindex -o test09-01.ind test09-01.idx
+ pdflatex --interaction=nonstopmode test09-01
+ pdflatex --interaction=nonstopmode test09-01
-* Major rewrite of documentation.
+* Split and convert the files. If `pdfjam` is not available, one would have to use other programs to do this.
-* The table of contents better frflects scope and sequence.
+ pdfjam --paper a6paper --landscape --quiet test07_02.pdf 3 --outfile cat01.pdf
+ pdfjam --paper a5paper --landscape --quiet test09_01.pdf 1 --outfile beamer01.pdf
+ pdfjam --paper a5paper --landscape --quiet test09_01.pdf 2 --outfile beamer02.pdf
+ pdfjam --paper a5paper --landscape --quiet test09_01.pdf 3 --outfile beamer03.pdf
-* The package itself has been reorganized to follow the same scope and sequence as the documentation.
+# 7 Additional Notes
-* Several macros have been optimized, leading to simpler and cleaner designs that are easier to debug. Additional bug fixes ensure stability,
+Starting from version 4.0 we switched from `xargs` and `suffix` to `xparse`. Should any modifications still require `xargs` and `suffix`, one can use the `oldargs` package option.
-* Name arguments shown in package warnings are detokenized in order to prevent potential errors.
+Version 3.7 remains here: [style](https://www.tug.org/svn/texlive/branches/branch2022.final/Master/texmf-dist/tex/latex/nameauth/), [docs](https://www.tug.org/svn/texlive/branches/branch2022.final/Master/texmf-dist/doc/latex/nameauth/), and [source](https://www.tug.org/svn/texlive/branches/branch2022.final/Master/texmf-dist/source/latex/nameauth/).
-# 8. Copyright
+# 8 Copyright
-Copyright (C) 2024 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+Copyright (C) 2025 by Charles P. Schaum <charles[dot]schaum@comcast.net>
This file 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:
+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:
- [https://www.latex-project.org/lppl.txt](https://www.latex-project.org/lppl.txt)
+[https://www.latex-project.org/lppl.txt](https://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.
+and version 1.3 or later is part of all distributions
+of LaTeX version 2005/12/01 or later.
+This work includes all source and generated files
+described as such in this file, README.md.
diff --git a/Master/texmf-dist/doc/latex/nameauth/beamer01.pdf b/Master/texmf-dist/doc/latex/nameauth/beamer01.pdf
index 52dc34c8414..cd60e0ad9e0 100644
--- a/Master/texmf-dist/doc/latex/nameauth/beamer01.pdf
+++ b/Master/texmf-dist/doc/latex/nameauth/beamer01.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nameauth/beamer02.pdf b/Master/texmf-dist/doc/latex/nameauth/beamer02.pdf
index 093b6b1eaf7..c76eac74435 100644
--- a/Master/texmf-dist/doc/latex/nameauth/beamer02.pdf
+++ b/Master/texmf-dist/doc/latex/nameauth/beamer02.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nameauth/beamer03.pdf b/Master/texmf-dist/doc/latex/nameauth/beamer03.pdf
index 4a337f45cc4..8ad08258587 100644
--- a/Master/texmf-dist/doc/latex/nameauth/beamer03.pdf
+++ b/Master/texmf-dist/doc/latex/nameauth/beamer03.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nameauth/cat01.pdf b/Master/texmf-dist/doc/latex/nameauth/cat01.pdf
index f4587eadb40..96ef09262d4 100644
--- a/Master/texmf-dist/doc/latex/nameauth/cat01.pdf
+++ b/Master/texmf-dist/doc/latex/nameauth/cat01.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nameauth/compat.tex b/Master/texmf-dist/doc/latex/nameauth/compat.tex
index 783e0e02484..9975f5571d6 100644
--- a/Master/texmf-dist/doc/latex/nameauth/compat.tex
+++ b/Master/texmf-dist/doc/latex/nameauth/compat.tex
@@ -8,56 +8,60 @@
%%
%% This is a generated file.
%%
-%% Copyright (C) 2024 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+%% Copyright (C) 2025 by Charles P. Schaum <charles[dot]schaum@comcast.net>
%%
-%% This file 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:
+%% This file 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:
%%
%% https://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.
+%% and version 1.3 or later is part of all distributions
+%% of LaTeX version 2005/12/01 or later.
+%%
+%% This work includes all source and generated files
+%% described as such in README.md, included herein.
%%
-
% This is not a standalone document.
% Use this file only in the document preamble.
+% Ensure that we have the needed macros.
+\usepackage{etoolbox}
+
+% Allow special catcodes.
\makeatletter
% Do not include the rest of this file
% unless we are in a document preamble.
-
\ifx\@onlypreamble\@notprerr\else
+ % Include the rest of this if--else statement.
-% Check against the latex version date. Create a macro
-% if the date is at least 2018/10/05 because that is
-% when Unicode processing changed for the better.
-
- \@ifl@t@r\fmtversion{2018/10/05}{\def\nameauthltx{}}{}
-
-% Here we check for 2018/04/30 because that is when xparse
-% added the ! modifier.
+ % Check against the latex version date. Create a macro
+ % if the date is at least 2018/10/05 because that is
+ % when Unicode processing changed for the better.
+ \@ifl@t@r\fmtversion{2018/10/05}{\newcommand\nameauthltx{}}{}
- \@ifl@t@r\fmtversion{2018/04/30}{\def\nameauthxp{}}{}
+ % Here we check for 2018/04/30 because that is when xparse
+ % added the ! modifier.
+ \@ifl@t@r\fmtversion{2018/04/30}{\newcommand\nameauthxp{}}{}
-% Here we assist backward compatibility for older
-% distributions of LaTeX and compatibility for multiple
-% LaTeX engines.
-
-% If we want to use TikZ, this flag will help us.
+ % Here we assist backward compatibility for older
+ % distributions of LaTeX and compatibility for multiple
+ % LaTeX engines.
+ % If we want to use TikZ, this flag will help us.
+ % We use this method to avoid crashing some \texttt{dvi}
+ % viewers. Define the macro \noTikZ to bypass this check.
\newif\ifDoTikZ
-% If we couch this statement in a conditional, we avoid
-% potential errors in older versions.
-
+ % If we couch this statement in a conditional, we avoid
+ % potential errors in older versions.
\IfFileExists{iftex.sty}{\usepackage{iftex}}{}
-% The presence of \RequireTUTeX means that these older
-% packages are not needed (thanks to iftex). Otherwise
-% we are using an older version and need these packages.
+ % The presence of \RequireTUTeX means that these older
+ % packages are not needed (thanks to iftex). Otherwise
+ % we are using an older version and need these packages.
\unless\ifdefined\RequireTUTeX
\usepackage{ifxetex}
@@ -65,51 +69,80 @@
\usepackage{ifpdf}
\fi
-% Instead of worrying about older or newer changes, we
-% ensure consistency when the LaTeX engine changes.
-% The goal is to get the same ``lmodern'' look.
-% Users will need to change language and font options
-% for their own needs.
+ % Instead of worrying about older or newer changes, we
+ % ensure consistency when the LaTeX engine changes.
+ % The goal is to get the same ``lmodern'' look.
+ % Users will need to change language and font options
+ % for their own needs.
+
+ % To remain compatible with our experience on older
+ % distributions, we load fontspec and prefer polyglossia
+ % with both XeLaTeX and LuaLaTeX. One cannot load both
+ % babel and polyglossia. See the relevant documentation.
+ % This flag causes polyglossia to be the default.
+ \newif\ifloadbabel
+
+ % Here we do the right thing for the right LaTeX version.
\ifxetex
+ % We always load fontspec in this case.
\usepackage{fontspec}
- \usepackage{polyglossia}
- \setdefaultlanguage{american}
- \DoTikZtrue % Loading TikZ will work (pdf)
+ % Loading TikZ will work (pdf)
+ \DoTikZtrue
\else
\ifluatex
\ifpdf
+ % This is the usual pdf-version lualatex.
+ % We always load fontspec in this case.
\usepackage{fontspec}
- \usepackage{polyglossia}
- \setdefaultlanguage{american}
- \DoTikZtrue % Loading TikZ will work (pdf)
+ % Loading TikZ will work (pdf)
+ \DoTikZtrue
\else
+ \loadbabeltrue
+ % This is dvilualatex (dvi mode).
\IfFileExists{utf8-2018.def}{}
{\usepackage[utf8]{inputenc}}
\usepackage[TS1,T1]{fontenc}
- \usepackage[american]{babel}
\usepackage{lmodern}
- % Using dvi-based workflows does not
- % work well with TikZ; pstricks instead
+ % No TikZ with dvi workflows for dvi viewers.
\fi
\else
+ \loadbabeltrue
+ % Here we load the same packages, whether dvi
+ % or pdf is being used. We address that below.
\IfFileExists{utf8-2018.def}{}
{\usepackage[utf8]{inputenc}}
\usepackage[TS1,T1]{fontenc}
- \usepackage[american]{babel}
\usepackage{lmodern}
- \ifpdf
- \usepackage{tikz}
- \DoTikZtrue % Loading TikZ will work (pdf)
- \fi
- % Using dvi-based workflows does not
- % work well with TikZ; pstricks instead
+ % Now we check for pdflatex. If so, use TikZ.
+ \ifpdf \DoTikZtrue \fi
+ % Otherwise, no TikZ with dvi workflows.
\fi
\fi
-% Here one would load TikZ if needed
-% \ifDoTikZ \usepackage{tikz} \fi
+ % Defining the \nolangs macro inhibits defaults.
+ \unless\ifdefined{\nolangs}
+ \ifloadbabel
+ \usepackage[american]{babel}
+ \else
+ \usepackage{polyglossia}
+ \setdefaultlanguage{american}
+ \fi
+ \fi
+ % Defining the \noTikZ macro inhibits defaults.
+ \unless\ifdefined{\noTikZ}
+ \ifDoTikZ
+ \usepackage{tikz}
+ \else
+ % Do something with pstricks, pdftricks, ps4pdf.
+ \fi
+ \fi
+
+% End of part needing to be in the preamble.
\fi
+% Return to normal catcodes.
\makeatother
+
+% End of included file.
diff --git a/Master/texmf-dist/doc/latex/nameauth/examples.tex b/Master/texmf-dist/doc/latex/nameauth/examples.tex
index 3a61ebcc26c..969f9fa054b 100644
--- a/Master/texmf-dist/doc/latex/nameauth/examples.tex
+++ b/Master/texmf-dist/doc/latex/nameauth/examples.tex
@@ -8,19 +8,21 @@
%%
%% This is a generated file.
%%
-%% Copyright (C) 2024 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+%% Copyright (C) 2025 by Charles P. Schaum <charles[dot]schaum@comcast.net>
%%
-%% This file 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:
+%% This file 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:
%%
%% https://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.
+%% and version 1.3 or later is part of all distributions
+%% of LaTeX version 2005/12/01 or later.
+%%
+%% This work includes all source and generated files
+%% described as such in README.md, included herein.
%%
-
\documentclass[oneside]{article}
\input{compat.tex} % Included with nameauth; needed only if
@@ -32,9 +34,8 @@
\usepackage{makeidx} % Must have for defining \seealso macro.
\usepackage{index}
-\usepackage[oldargs]{nameauth}[2024/02/09]
+\usepackage[oldargs]{nameauth}[2025/02/04]
-\usepackage[inline]{enumitem}
\usepackage{fancyvrb}
% Define fancyvrb defaults.
@@ -42,40 +43,37 @@
\usepackage{xcolor}
\usepackage[colorlinks=true]{hyperref}
+
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Set up indexing and put margin paragraphs on the left.
%
+
\makeindex
\newindex{per}{rdx}{rnd}{Index of Persons}
\renewcommand\NameauthIndex{\index[per]}
\reversemarginpar
-%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-% Global definitions of conditionals for examples and
-% Global definitions of macros for examples could occur
-% here, but we put those instead in the sections where
-% they appear.
+
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Create name shorthands. Note the use of \noexpand
% in the macro arguments below.
%
+
\begin{nameauth}
- \< Doug & Frederick & Douglass & >
- \< Bailey & Betsey & Bailey & >
+ \< Doug & Frederick & Douglass & >
+ \< Bailey & Betsey & Bailey & >
\end{nameauth}
\begin{nameauth}
\< Wash & George & Washington & >
+ \< Bradley & Omar N. & Bradley & >
\< Aris & & Aristotle & >
\< Plato & & Plato & >
- \< Aeth & & Æthelred, II & >
- \< Sun & & Sun, Yat-sen & >
+ \< Aeth & & \AE thelred, II & >
\< Linc & Abraham & Lincoln & >
\< MLK & Martin Luther & King, Jr. & >
\< Soto & Hernando & de Soto & >
- \< Goethe & J.W. von & Goethe & >
\< Patton & George S. & Patton, Jr. & >
\< Ike & Dwight D. & Eisenhower & >
\end{nameauth}
@@ -117,8 +115,14 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Below we establish sort tags for names.
%
+
+% Sort these names under: US Generals.
+\PretagName[Omar N.]{Bradley}{US Generals!Bradley, Omar}
+\PretagName[George S.]{Patton, Jr.}{US Generals!Patton, George}
+
% Sort these names under: US Presidents.
\PretagName[George]{Washington}{US Presidents!Washington, George}
+\PretagName[Dwight D.]{Eisenhower}{US Presidents!Eisenhower, Dwight D.}
\PretagName[Abraham]{Lincoln}{US Presidents!Lincoln, Abraham}
% Sort these names under: Philosophers.
@@ -128,71 +132,85 @@
% Sort these names under: Black Americans, famous.
\PretagName[Frederick]{Douglass}
{Black Americans, famous!Douglass, Frederick}
-\PretagName[Betsey]{Bailey}
- {Black Americans, famous!Bailey, Betsey}
\PretagName[Martin Luther]{King, Jr.}
{Black Americans, famous!King, Martin Luther, Jr.}
% Sort these names under: Europeans, historical.
-\PretagName{Æthelred, II}{Europeans, historical!Aethelred 2}
+\PretagName{\AE thelred, II}{Europeans, historical!Aethelred 2}
\PretagName[Hernando]{de Soto}
{Europeans, historical!de Soto, Hernando}
+
\PretagName{Vlad, Ţepeş}{Vlad Tepes} % for accented names
+
\PretagName[Konrad]{\noexpand\textSC{Zuse}}{Zuse, Konrad}
\PretagName[Ada]{\noexpand\textIT{Lovelace}}{Lovelace, Ada}
\PretagName[Charles]{\noexpand\textBF{Babbage}}
{Babbage, Charles}
\PretagName{\noexpand\textUC{Kanade}, Takeo}{Kanade Takeo}
+
\PretagName[Martin]{\noexpand\textSC{Luther}}{Luther, Martin}
\PretagName[Catherine \noexpand\AltCaps{d}e']
{\noexpand\textSC{Medici}}{Medici, Catherine de}
+
\PretagName[Thomas]{\noexpand\textSC{Jefferson}\noexpand\GEN{}}
{Jefferson, Thomas}
+
\PretagName[Greta]{\noexpand\textSC{Garbo}}{Garbo, Greta}
\PretagName{\noexpand\textSC{Misora}, Hibari}{Misora Hibari}
\PretagName[Heinz]{\noexpand\textSC{R\"uhmann}}{Ruehmann, Heinz}
\PretagName[Heinrich Wilhelm]{\noexpand\textSC{R\"uhmann}}
{Ruehmann, Heinrich Wilhelm}
+
\PretagName[\noexpand\SCIPi]{\noexpand\SCIPii}
{Scipio Africanus}
\PretagName[\noexpand\TSemp]{Gracchus}
{Gracchus, Tiberius Sempronius}
+
\PretagName[Lucius]{\noexpand\CSB}{Cornelius Scipio Barbatus}
+
\PretagName[\noexpand\WM]{\noexpand\SHK}
{Shakespeare, William}
\PretagName[Robert]{\textSC{Burns}}{Burns, Robert}
+
\PretagName[Pierre-Jean]%
{\noexpand\Fbox{\noexpand\AltCaps{d}e~Smet}}%
{de~Smet, Pierre-Jean}
+
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Below we establish some index tags for names.
%
-\TagName[George S.]{Patton, Jr.}{, general}
+
\TagName{Vlad, II}{ Dracul}
\TagName{Vlad, III}{ Dracula}
\IndexRef{Dracula}{Vlad III}
+
+
\TagName[Thomas]{\noexpand\textSC{Jefferson}\noexpand\GEN{}}
{, pres.}
+
+
\TagName[\noexpand\TSemp]{Gracchus}{, consul}
+
+
\TagName[Lucius]{\noexpand\CSB}{, consul}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
-\title{\bfseries Some Examples}
+\title{\bfseries Some \textsf{nameauth} Examples}
\author{Charles P. Schaum}
-\date{2024/02/09}
+\date{2025/02/04}
\begin{document}
\maketitle
@@ -205,66 +223,147 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Minimal Example}
-\textbf{Group 1}\\
-\begin{enumerate*}
+\textbf{Group 1}
+\begin{enumerate}
\item[\textbf{1.}] \Doug\ rose to eminence by sheer force
of character and talents that neither slavery nor caste
proscription could crush.
\item[\textbf{2.}] \Doug's early life is perhaps the most
complete indictment of the slave system ever presented at
the bar of public opinion.
- \item[\textbf{3.}] \Doug\ was born in February, l8l7. His
+ \item[\textbf{3.}] \Doug\ was born in February, 1817. His
earliest memories centered around the cabin of his
grandmother, \Bailey.
-\end{enumerate*}
+\end{enumerate}
-\medskip\noindent\textbf{Group 2}\\
+\medskip\noindent\textbf{Group 2}
\ForgetName[Frederick]{Douglass}
\ForgetName[Betsey]{Bailey}
-\begin{enumerate*}
+\begin{enumerate}
\item[\textbf{2.}] \Doug's early life is perhaps the most
complete indictment of the slave system ever presented at
the bar of public opinion.
- \item[\textbf{3.}] \Doug\ was born in February, l8l7. His
+ \item[\textbf{3.}] \Doug\ was born in February, 1817. His
earliest memories centered around the cabin of his
grandmother, \Bailey.
\item[\textbf{1.}] \Doug\ rose to eminence by sheer force
of character and talents that neither slavery nor caste
proscription could crush.
-\end{enumerate*}
+\end{enumerate}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
+\section{Roman Names I}
+
+Here we modify a few details from the manual in order to make
+all the name examples work well together.
+
+\newcommand\nri{}
+\newcommand\nrii{}
+
+\begin{nameauth}
+ \< Senecai & Lucius Annaeus & Seneca\nri & >
+ \< Senecaii & Lucius Annaeus & Seneca\nrii & >
+\end{nameauth}
+
+\renewcommand*\NamesFormat[1]
+ {#1\NameQueryInfo{}}
+
+\PretagName[Lucius Annaeus]{Seneca\nri}{Seneca, Lucius Annaeus 1}
+\PretagName[Lucius Annaeus]{Seneca\nrii}{Seneca, Lucius Annaeus 2}
+\TagName[Lucius Annaeus]{Seneca\nri}{ (the Elder)}
+\TagName[Lucius Annaeus]{Seneca\nrii}{ (the Younger)}
+\NameAddInfo[Lucius Annaeus]{Seneca\nri}{ the Elder}
+\NameAddInfo[Lucius Annaeus]{Seneca\nrii}{ the Younger}
+
+We can differentiate between
+\Senecai\ and \Senecaii;
+\Senecai \NameQueryInfo{} and \Senecaii \NameQueryInfo{}.
+
+Their full index entries are:\\
+\ShowIdxPageref[Lucius Annaeus]{Seneca\nri}\\
+\ShowIdxPageref[Lucius Annaeus]{Seneca\nrii}
+\index{Roman names, student}
+
+
+\begin{nameauth}
+ \< CatoY & Marcus Porcius & Cato, the Younger & >
+ \< CatoYi & Marcus Porcius & Cato the Younger & >
+\end{nameauth}
+\ExcludeName[Marcus Porcius]{Cato, the Younger}
+\makeatletter
+\NameAddInfo[Marcus Porcius]{Cato, the Younger}
+ {\if@nameauth@InHook\ (Uticensis, 94--45 \textsc{bc})%
+ \else Uticensis\fi}
+\makeatother
+
+\JustIndex\CatoYi
+\CatoY\ is known as \CatoY\ \ForceAffix\CatoY, to distinguish him
+from his great-grandfather. His names include \SCatoY[Marcus]
+(\textit{praenomen}), \SCatoY[Porcius] (\textit{nomen}, one of the
+Porcia clan), and \CatoY, the \textit{cognomen} by which he is best
+known. His other \textit{agnomen}, \NameQueryInfo{}, means he was
+born in Utica.
+\JustIndex\CatoYi He is indexed as: \ShowIdxPageref*{}
+\index{Roman names, student}
+
+
+\begin{nameauth}
+ \< CatoE & Marcus Porcius & Cato, the Elder & >
+ \< CatoEi & Marcus & Porcius Cato the Elder & >
+\end{nameauth}
+\ExcludeName[Marcus Porcius]{Cato, the Elder}
+
+\JustIndex\CatoEi
+\DropAffix\CatoE\ (234--149 \textsc{bc}) is known as
+\CatoE{} \ForceAffix\CatoE, among other sobriquets.
+His \textit{praenomen} is \SCatoE[Marcus]. His
+\textit{nomen} is \SCatoE[Porcius], a member of the
+Porcia clan. His \textit{cognomen} is \CatoE.
+\JustIndex\CatoEi
+Index: \ShowIdxPageref*{}
+\index{Roman names, scholar}
+
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+
\section{Multiple Indexes}
-The Electric Boogaloo\index{Boogaloo, Electric}\\ % main index
-was created by \Name{Ollie~\& Jerry}. % name index
+The Electric Boogaloo\index{Boogaloo, Electric} % main index
+was created by \Name{Ollie~\& Jerry}. % name index
\index{indexes, multiple}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Index Categories}
\subsection{Famous Black Americans}
-\ForgetThis\Name[Frederick]{Douglass} rose to eminence by sheer
-force of character and talents that neither slavery nor caste
+\Name[Frederick]{Douglass} rose to eminence by sheer force of
+character and talents that neither slavery nor caste
proscription could crush. Circumstances made
\Name[Frederick]{Douglass} a slave, but they could not prevent
him from becoming a freeman and a leader among mankind.\\
+
We also celebrate \MLK, then \MLK.
\subsection{Patres Patriae}
We mention President \Wash; again, \Wash.
-Family and close friends called him \SWash.%
+Family and close friends called him \SWash.\\
+
\TagName[George]{Washington}{!as general}
-We reminisce about \LWash[General].%
+We can reminisce about \LWash[General].
\UntagName[George]{Washington}
+
When speaking of \Linc, we can refer to \LLinc[Abe].
\subsection{Philosophers}
@@ -274,7 +373,6 @@ Among philosophers we consider \Plato\ and \Aris.
\subsection{Historical Figures}
We ponder about \Aeth, then \Aeth.
-We speak of \Sun, then \Sun.
We note \Soto, then just \Soto.
\CapThis\Soto{} starts a sentence.
@@ -282,18 +380,28 @@ We note \Soto, then just \Soto.
\TagName[George]{Washington}{!as general}
\TagName[Dwight D.]{Eisenhower}{!as general}
-\LWash, \LPatton, and \LIke\ were high-ranking generals.%
-\TagName[Dwight D.]{Eisenhower}{!as president}
-\UntagName[George]{Washington}%
+\LWash, \LIke, \LBradley, and \LPatton
+ were high-ranking generals.\\
+\SeeAlso\IndexRef[George]{Washington}{Eisenhower}
+\SeeAlso\IndexRef[Dwight D.]{Eisenhower}{Washington}
+\IncludeName*[George]{Washington}
+\IncludeName*[Dwight D.]{Eisenhower}
+
+\UntagName[George]{Washington}
+\UntagName[Dwight D.]{Eisenhower}
\Wash\ and \Ike\ also were US presidents.
-\small
-% Instead of pre-tagging Ike we do the following:
-\index[per]{US Presidents!other|see{Eisenhower, Dwight D., president}}
+\ForgetName[Omar N.]{Bradley}
+\ForgetName[George S.]{Patton, Jr.}
+\TagName[Omar N.]{Bradley}{!colleagues of}
+\TagName[George S.]{Patton, Jr.}{!colleagues of}
+\IndexRef[Omar N.]{Bradley}{Eisenhower, Patton}
+\IndexRef[George S.]{Patton, Jr.}{Bradley, Eisenhower}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{More Complex Hooks}
% First save main- and front-matter hooks. Then change
@@ -307,7 +415,8 @@ We note \Soto, then just \Soto.
\marginpar{\raggedleft\scriptsize #1}\fi}
\index{complex hooks, intro}
-The new format (front matter):\NamesInactive
+\subsection{New Format, Front Matter}
+\NamesInactive
\Name{Vlad, III}[III Dracula], known as
\IndexRef{Vlad, Ţepeş}{Vlad III}
@@ -317,7 +426,8 @@ after his death, was the son of \Name{Vlad, II}[II Dracul],
a member of the Order of the Dragon. Later instances of
``\Name*{Vlad, III}'' and ``\Name{Vlad, III}'' appear thus.
-The new format (main matter):\NamesActive
+\subsection{New Format, Main Matter}
+\NamesActive
\Name{Vlad, III}[III Dracula], known as
\IndexRef{Vlad, Ţepeş}{Vlad III}
@@ -330,19 +440,137 @@ a member of the Order of the Dragon. Later instances of
\let\NamesFormat\OldFormat
\let\FrontNamesFormat\OldFrontNames
-We are back in the old format.
+\subsection{Old Format, Front and Main}
-in the front matter we see: \NamesInactive
+\NamesInactive In the front matter we see:
\ForgetThis\Name{Vlad, III}[III Dracula],
-\Name*{Vlad, III}, and \Name{Vlad, III}.
+\Name*{Vlad, III}, and \Name{Vlad, III}.\\
-in the main matter we see: \NamesActive
+\NamesActive\noindent In the main matter we see:
\ForgetThis\Name{Vlad, III}[III Dracula],
\Name*{Vlad, III}, and \Name{Vlad, III}.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
+\section{Template Test}
+
+Here we demonstrate that fetching information by using the name pattern is better than reading the internal token registers. This is due to expansion sometimes happening in the basic interface.
+
+We set up the following test for our three templates, with indexing suppressed:
+
+\begin{itemize}
+ \item If we see the outcome, ``Test\dots passed'', we have success.
+ \item If we see the outcome, ``Test\dots'', we have failure.
+\end{itemize}
+
+\subsection{Test Setup}
+
+\begingroup
+
+\IndexInactive
+\begin{VerbatimOut}{\jobname.tmp}
+ \NameAddInfo{Testi}{\dots passed}
+ \NameAddInfo{\noexpand\testname}{\dots passed}
+ \newcommand\testname{Testii}
+ \begin{nameauth}
+ \< Testi & & Testi & >
+ \< Testii & & \noexpand\testname & >
+ \end{nameauth}
+\end{VerbatimOut}
+
+\VerbatimInput[gobble=0]{\jobname.tmp}
+
+\input{\jobname.tmp}
+
+\subsection{Recommended Hook}
+
+We display the name, followed by the tag produced with the most recent name pattern vis: \Verb+\NameQueryInfo{}+ taking a null argument.
+
+\begin{VerbatimOut}{\jobname.tmp}
+ \renewcommand*\NamesFormat[1]
+ {#1\NameQueryInfo{}}
+\end{VerbatimOut}
+
+\VerbatimInput[gobble=0]{\jobname.tmp}
+\input{\jobname.tmp}
+
+\begin{tabular}{ll}
+ \Verb+\ForgetThis\Name{Testi}+ & \ForgetThis\Name{Testi} \\
+ \Verb+\ForgetThis\Testi+ & \ForgetThis\Testi \\
+ \Verb+\ForgetThis\Name{\noexpand\testname}+ &
+ \ForgetThis\Name{\noexpand\testname} \\
+ \Verb+\ForgetThis\Testii+ & \ForgetThis\Testii \\
+\end{tabular}
+
+\subsection{Alternate Hook A}
+
+If we try to use the internal token registers, we have to get more complicated, and it does not always work:
+
+\begin{VerbatimOut}{\jobname.tmp}
+ \makeatletter
+ \renewcommand*\NamesFormat[1]{%
+ \begingroup%
+ \protected@edef\temp{\endgroup%
+ {#1\noexpand\NameQueryInfo
+ [\unexpanded\expandafter{\the\@nameauth@toksa}]
+ {\unexpanded\expandafter{\the\@nameauth@toksb}}
+ [\unexpanded\expandafter{\the\@nameauth@toksc}]%
+ }%
+ }%
+ \temp%
+ }
+ \makeatother
+\end{VerbatimOut}
+
+\VerbatimInput[gobble=0]{\jobname.tmp}
+\input{\jobname.tmp}
+
+\begin{tabular}{ll}
+ \Verb+\ForgetThis\Name{Testi}+ & \ForgetThis\Name{Testi} \\
+ \Verb+\ForgetThis\Testi+ & \ForgetThis\Testi \\
+ \Verb+\ForgetThis\Name{\noexpand\testname}+ &
+ \ForgetThis\Name{\noexpand\testname} \\
+ \Verb+\ForgetThis\Testii+ & \ForgetThis\Testii \\
+\end{tabular}
+
+
+\subsection{Alternate Hook B}
+
+This is an ``older'' way of using the internal token registers. It has similar problems with consistency:
+
+\begin{VerbatimOut}{\jobname.tmp}
+ \let\ex\expandafter
+ \makeatletter
+ \renewcommand*\NamesFormat[1]{%
+ #1%
+ \ex\ex\ex\ex\ex\ex\ex\NameQueryInfo%
+ \ex\ex\ex\ex\ex\ex\ex[\ex\ex\ex\the%
+ \ex\ex\ex\@nameauth@toksa\ex\ex\ex]%
+ \ex\ex\ex{\ex\the\ex\@nameauth@toksb\ex}%
+ \ex[\the\@nameauth@etoksc]%
+ }
+ \makeatother
+\end{VerbatimOut}
+
+\VerbatimInput[gobble=0]{\jobname.tmp}
+\input{\jobname.tmp}
+
+\begin{tabular}{ll}
+ \Verb+\ForgetThis\Name{Testi}+ & \ForgetThis\Name{Testi} \\
+ \Verb+\ForgetThis\Testi+ & \ForgetThis\Testi \\
+ \Verb+\ForgetThis\Name{\noexpand\testname}+ &
+ \ForgetThis\Name{\noexpand\testname} \\
+ \Verb+\ForgetThis\Testii+ & \ForgetThis\Testii \\
+\end{tabular}
+
+\endgroup
+
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+
\section{Life Dates in Hooks}
% Add name tags to names.
@@ -364,28 +592,27 @@ in the main matter we see: \NamesActive
\renewcommand*\NamesFormat[1]
{%
- #1%
- \ifcsname\NameauthPattern!DB\endcsname
- \unless\ifNoTag
- \expandafter\csname\NameauthPattern!DB\endcsname%
- \fi
- \global\NoTagfalse%
- \fi
+ #1\unless\ifNoTag\NameQueryInfo{}\fi
+ \global\NoTagfalse%
}
-\ForgetThis\Name[George]{Washington} held office as the first US
-president from 1789 to 1797. \Name[George]{Washington} was the only
-president whose term in office was completely in the eighteenth
-century. If we need to trigger the first use hook at some point,
+\ForgetThis\Name[George]{Washington} held office as
+the first US president from 1789 to 1797.
+\Name[George]{Washington} was the only president whose
+term in office was completely in the eighteenth century.
+
+If we need to trigger the first use hook at some point,
we can suppress dates and get an automatic long instance via:
-\NoTagtrue\ForgetThis\Name[George]{Washington}. Or we can trigger
-the first-use hook in a subsequent name use and still have dates:
-\ForceName\Name[George]{Washington}.
-\index{life dates}
+\NoTagtrue\ForgetThis\Name[George]{Washington}.
+
+Or we can trigger the first-use hook in a subsequent name use
+and still have dates: \ForceName\Name[George]{Washington}.
We can add name info tags to names used only as cross-
references. For example, \Name[Mustafa]{Kemal} was granted
-the name \Name{Atat\"urk}. We mention \Name[Mustafa]{Kemal}
+the name \Name{Atat\"urk}.
+
+We mention \Name[Mustafa]{Kemal}
and \Name{Atat\"urk} again. Likewise, we can trigger a
first use, but with no name tag tag:
\NoTagtrue\ForgetThis\Name{Atat\"urk}.
@@ -393,6 +620,7 @@ first use, but with no name tag tag:
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Alternate Formatting}
\AltFormatActive
@@ -427,6 +655,7 @@ murder of thousands of Huguenots.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Grammatical Inflections in Names}
\newif\ifGenitive
@@ -449,6 +678,7 @@ public policy and in personal affairs.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Sample Reference Work I}
% Make a cross-reference from a variant name form to the
@@ -468,8 +698,8 @@ public policy and in personal affairs.
\newcommand{\RefArticle}[3]
{%
- \def\check{#2}%
- \ifx\check\empty
+ \def\Check{#2}%
+ \ifx\Check\empty
\noindent\ForgetThis\textsl{#1}\ #3
\else
\noindent\ForgetThis\textsl{#1}\ #2\ #3
@@ -502,7 +732,10 @@ public policy and in personal affairs.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
-\section{Roman Names: Student Reference}
+
+\section{Roman Names II}
+
+\subsection{General Reference}
% Global Boolean flags need to be defined only once.
\newif\ifNoPraenomen
@@ -560,7 +793,7 @@ public policy and in personal affairs.
\ifNoGens\XGenstrue\fi%
\ifNoCognomen\XCogntrue\fi%
\ifNoAgnomen\XAgnotrue\fi%
- #1%
+ #1\NameQueryInfo{}%
\global\NoPraenomenfalse%
\global\NoGensfalse%
\global\NoCognomenfalse%
@@ -591,36 +824,13 @@ He flourished during the Egyptian reigns of
reigns of \Name{Seleucus, III}[III Ceraunus] and
\Name{Antiochus, III}[III the Great].
-% We make no change to \MainNameHook, but we do
-% change \NamesFormat to display any extant
-% name tags.
-
-\renewcommand*\NamesFormat[1]
-{%
- \ifNoPraenomen\XPraetrue\fi%
- \ifNoGens\XGenstrue\fi%
- \ifNoCognomen\XCogntrue\fi%
- \ifNoAgnomen\XAgnotrue\fi%
- #1%
- \ifcsname\NameauthPattern!DB\endcsname
- \expandafter\csname\NameauthPattern!DB\endcsname%
- \fi
- \global\NoPraenomenfalse%
- \global\NoGensfalse%
- \global\NoCognomenfalse%
- \global\NoAgnomenfalse%
-}
-
\TGrac\ served as tribune of the plebs in 184 \textsc{bc}.
\TGrac\ was elected praetor for 180 \textsc{bc},
after which he was appointed governor of Hispania Citerior,
serving with the rank of proconsul. In 177 \textsc{bc},
he was elected consul, again in 163 \textsc{bc}.
-%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%
-\section{Roman Names: Scholarly Work}
+\subsection{Scholarly Work}
% Name variant macros need to be defined
% uniquely for each name.
@@ -649,10 +859,11 @@ and served during the Third Samnite War.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Reference Work II}
% Boolean flags; the first sets up headwords and the second
-% indicates that a nonwestern form should not be reversed.
+% indicates that a Non-Western form should not be reversed.
\newif\ifHeadword
\newif\ifAncientName
@@ -674,22 +885,16 @@ and served during the Third Samnite War.
\ifNameauthWestern
\@nameauth@RevThisCommatrue%
\bfseries \NameParser%
- \normalfont%
- \ifcsname\NameauthPattern!DB\endcsname
- \expandafter\csname\NameauthPattern!DB\endcsname%
- \fi
+ \normalfont\NameQueryInfo{}%
\else
- \bgroup%
+ \begingroup%
\bfseries \NameParser%
\unless\ifAncientName
\normalfont; W:\AltOff\space
\@nameauth@RevThistrue \NameParser%
\fi
- \normalfont%
- \ifcsname\NameauthPattern!DB\endcsname
- \expandafter\csname\NameauthPattern!DB\endcsname%
- \fi
- \egroup%
+ \normalfont\NameQueryInfo{}%
+ \endgroup%
\fi
\else
\NameParser%
@@ -704,7 +909,8 @@ and served during the Third Samnite War.
\newcommand\Headword{\Headwordtrue\ForgetThis}
\renewcommand{\RefArticle}[2]
{%
- \noindent\Headword #1 #2%
+ \noindent\Headword #1 #2
+ \medskip
}
\index{reference work}
@@ -730,6 +936,7 @@ Engine. \Name[Ada]{\noexpand\textIT{Lovelace}}\dots}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Marginalia}
% Global Boolean flags need to be defined only once.
@@ -819,7 +1026,8 @@ in the 1800s, \Revert\Shak\ became known as ``\Shak''.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
-\section{Customization, Easy}
+
+\section{Customization Using Internals}
\makeatletter
\newcommand*\Fbox[1]{%
@@ -842,7 +1050,10 @@ among American Indian nations after 1837. We can show the forms
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
-\section{Customization, Complicated}
+
+\section{Customization Using Separate Macros}
+
+We do not show this section in the manual because it starts to go farther afield of the main focus of \textsf{nameauth}. Nevertheless, we show it for completeness.
\newif\ifFbox % Replaces \if@nameauth@DoAlt \AltOn \AltOff
\newif\ifFirstCap % Replaces \if@nameauth@DoCaps \AltCaps
@@ -924,7 +1135,10 @@ murder of thousands of Huguenots.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
-\section{Customization, Complete}
+
+\section{Full Customization}
+
+We do not go into this much detail in the manual because it starts to go farther afield of the main focus of \textsf{nameauth}. Nevertheless, we show it for completeness.
\subsection[With xparse]{With \textsf{xparse}}
@@ -933,28 +1147,16 @@ murder of thousands of Huguenots.
% Change the general-case name macro to show
% a name in a framed, colored box.
-\NewDocumentCommand{\MyName}{O{} m O{}}{%
- \global\@nameauth@toksa\expandafter{#1}%
- \global\@nameauth@toksb\expandafter{#2}%
- \global\@nameauth@toksc\expandafter{#3}%
- \fcolorbox{black}{gray!25!white}{\@nameauth@Name[#1]{#2}[#3]}%
-}
+\NewDocumentCommand{\MyName}{O{} m O{}}
+ {\fcolorbox{black}{gray!25!white}{\@nameauth@Name[#1]{#2}[#3]}}
% Likewise change the macro for when names are forced long.
-\NewDocumentCommand{\MyLName}{O{} m O{}}{%
- \global\@nameauth@toksa\expandafter{#1}%
- \global\@nameauth@toksb\expandafter{#2}%
- \global\@nameauth@toksc\expandafter{#3}%
- \fcolorbox{black}{green!25!white}{\@nameauth@Name[#1]{#2}[#3]}%
-}
+\NewDocumentCommand{\MyLName}{O{} m O{}}
+ {\fcolorbox{black}{green!25!white}{\@nameauth@Name[#1]{#2}[#3]}}
% Likewise change the macro when personal names are desired.
-\NewDocumentCommand{\MyFName}{O{} m O{}}{%
- \global\@nameauth@toksa\expandafter{#1}%
- \global\@nameauth@toksb\expandafter{#2}%
- \global\@nameauth@toksc\expandafter{#3}%
- \fcolorbox{black}{yellow!25!white}{\@nameauth@Name[#1]{#2}[#3]}%
-}
+\NewDocumentCommand{\MyFName}{O{} m O{}}
+ {\fcolorbox{black}{yellow!25!white}{\@nameauth@Name[#1]{#2}[#3]}}
\makeatother
% Change the formatting hooks, but do not use alternate.
@@ -986,32 +1188,19 @@ century; \Name*[Adolf von]{Harnack}; \FName[Adolf]{Harnack}.
\subsection[With xargs]{With \textsf{xargs}}
\makeatletter
-
% Change the general-case name macro to show
% a name in a framed, colored box.
-\renewcommandx\MyName[3][1=\empty, 3=\empty]{%
- \global\@nameauth@toksa\expandafter{#1}%
- \global\@nameauth@toksb\expandafter{#2}%
- \global\@nameauth@toksc\expandafter{#3}%
- \fcolorbox{black}{gray!25!white}{\@nameauth@Name[#1]{#2}[#3]}%
-}
+\renewcommandx\MyName[3][1=\empty, 3=\empty]
+ {\fcolorbox{black}{gray!25!white}{\@nameauth@Name[#1]{#2}[#3]}}
% Likewise change the macro for when names are forced long.
-\renewcommandx\MyLName[3][1=\empty, 3=\empty]{%
- \global\@nameauth@toksa\expandafter{#1}%
- \global\@nameauth@toksb\expandafter{#2}%
- \global\@nameauth@toksc\expandafter{#3}%
- \fcolorbox{black}{green!25!white}{\@nameauth@Name[#1]{#2}[#3]}%
-}
+\renewcommandx\MyLName[3][1=\empty, 3=\empty]
+ {\fcolorbox{black}{green!25!white}{\@nameauth@Name[#1]{#2}[#3]}}
% Likewise change the macro when personal names are desired.
-\renewcommandx\MyFName[3][1=\empty, 3=\empty]{%
- \global\@nameauth@toksa\expandafter{#1}%
- \global\@nameauth@toksb\expandafter{#2}%
- \global\@nameauth@toksc\expandafter{#3}%
- \fcolorbox{black}{yellow!25!white}{\@nameauth@Name[#1]{#2}[#3]}%
-}
+\renewcommandx\MyFName[3][1=\empty, 3=\empty]
+ {\fcolorbox{black}{yellow!25!white}{\@nameauth@Name[#1]{#2}[#3]}}
\makeatother
% Change the formatting hooks, but do not use alternate.
@@ -1043,20 +1232,23 @@ century; \Name*[Adolf von]{Harnack}; \FName[Adolf]{Harnack}.
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{\protect\LaTeX\ Engines}
-We use \texttt{american} for the language; one should use one's own.
-We use Latin Modern for the font; that should be changed at the user's
-discretion. We could load \textsf{tikz} using
-\texttt{\textbackslash ifDoTikZ} to avoid crashing some \texttt{dvi}
-viewers in a \texttt{dvi}-only workflow. Below we list the salient
-points from \texttt{compat.tex}, included with \textsf{nameauth}.
+\subsection{\protect\texttt{compat.tex}}
+
+One can define \Verb+\nolangs+ before loading the file below to inhibit
+the default language loading. We use Latin Modern for the font to get
+a consistent look. Below we list the salient cross-engine points from
+\texttt{compat.tex}, included with \textsf{nameauth}.
\index{\protect\LaTeX\ engines}
\begin{quote}\small
- \VerbatimInput[gobble=0, firstline=29]{compat.tex}
+ \VerbatimInput[gobble=0, firstline=24]{compat.tex}
\end{quote}
+\subsection{Check Engine Tests}
+
In the body text we can use something like the test below for:\quad
\fbox{\ifxetex doing \texttt{pdf} things\else
\ifpdf doing \texttt{pdf} things\else
@@ -1095,8 +1287,6 @@ or just the body text to work under multiple engines:
\fi
\end{Verbatim}
-\newpage
-
\begin{Verbatim}
\unless\ifxetex
\unless\ifluatex
@@ -1116,6 +1306,7 @@ or just the body text to work under multiple engines:
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\section{Miscellaneous Tests: Spaces}
Here we test to see if any unwanted spaces exist in macros that take
@@ -1124,25 +1315,29 @@ name arguments. If everything is OK, one should see two vertical bars
between an enclosed name and the bars. This section also tests if most
possible argument combinations work in most macros that take name arguments.
+\subsection{Western Name with Suffix}
+
\begin{quote}
-\Verb+\Name[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\Name[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\Name*[FNNa]{SNNa,Affix}+\dotfill
- |\Name*[FNNa]{SNNa,Affix}|\\
-\Verb+\DropAffix\Name*[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\DropAffix\Name*[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\DropAffix\Name*[FNNa]{SNNa,Affix}+\dotfill
- |\DropAffix\Name*[FNNa]{SNNa,Affix}|\\
-\Verb+\Name[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\Name[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\Name[FNNa]{SNNa,Affix}+\dotfill
- |\Name[FNNa]{SNNa,Affix}|\\
-\Verb+\FName[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\FName[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\FName[FNNa]{SNNa,Affix}+\dotfill
- |\FName[FNNa]{SNNa,Affix}|
+\Verb+\Name[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\Name[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\Name*[FNNa]{SNNa, Affix}+\dotfill
+ |\Name*[FNNa]{SNNa, Affix}|\\
+\Verb+\DropAffix\Name*[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\DropAffix\Name*[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\DropAffix\Name*[FNNa]{SNNa, Affix}+\dotfill
+ |\DropAffix\Name*[FNNa]{SNNa, Affix}|\\
+\Verb+\Name[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\Name[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\Name[FNNa]{SNNa, Affix}+\dotfill
+ |\Name[FNNa]{SNNa, Affix}|\\
+\Verb+\FName[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\FName[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\FName[FNNa]{SNNa, Affix}+\dotfill
+ |\FName[FNNa]{SNNa, Affix}|
\end{quote}
+\subsection{Western Name without Suffix}
+
\begin{quote}
\Verb+\Name[FNNb]{SNNb}[Alternate]+\dotfill
|\Name[FNNb]{SNNb}[Alternate]|\\
@@ -1158,25 +1353,29 @@ possible argument combinations work in most macros that take name arguments.
|\FName[FNNb]{SNNb}|
\end{quote}
+\subsection{Non-Western Name, Current Syntax}
+
\begin{quote}
-\Verb+\Name{SNNc,Affix}[Alternate]+\dotfill
- |\Name{SNNc,Affix}[Alternate]|\\
-\Verb+\Name*{SNNc,Affix}+\dotfill
- |\Name*{SNNc,Affix}|\\
-\Verb+\Name{SNNc,Affix}[Alternate]+\dotfill
- |\Name{SNNc,Affix}[Alternate]|\\
-\Verb+\Name{SNNc,Affix}+\dotfill
- |\Name{SNNc,Affix}|\\
-\Verb+\FName{SNNc,Affix}[Alternate]+\dotfill
- |\FName{SNNc,Affix}[Alternate]|\\
-\Verb+\FName{SNNc,Affix}+\dotfill
- |\FName{SNNc,Affix}|\\
-\Verb+\ForceFN\FName{SNNc,Affix}[Alternate]+\dotfill
- |\ForceFN\FName{SNNc,Affix}[Alternate]|\\
-\Verb+\ForceFN\FName{SNNc,Affix}+\dotfill
- |\ForceFN\FName{SNNc,Affix}|
+\Verb+\Name{SNNc, Affix}[Alternate]+\dotfill
+ |\Name{SNNc, Affix}[Alternate]|\\
+\Verb+\Name*{SNNc, Affix}+\dotfill
+ |\Name*{SNNc, Affix}|\\
+\Verb+\Name{SNNc, Affix}[Alternate]+\dotfill
+ |\Name{SNNc, Affix}[Alternate]|\\
+\Verb+\Name{SNNc, Affix}+\dotfill
+ |\Name{SNNc, Affix}|\\
+\Verb+\FName{SNNc, Affix}[Alternate]+\dotfill
+ |\FName{SNNc, Affix}[Alternate]|\\
+\Verb+\FName{SNNc, Affix}+\dotfill
+ |\FName{SNNc, Affix}|\\
+\Verb+\ForceFN\FName{SNNc, Affix}[Alternate]+\dotfill
+ |\ForceFN\FName{SNNc, Affix}[Alternate]|\\
+\Verb+\ForceFN\FName{SNNc, Affix}+\dotfill
+ |\ForceFN\FName{SNNc, Affix}|
\end{quote}
+\subsection{Non-Western Name, Obsolete Syntax}
+
\begin{quote}
\Verb+\Name{SNNd}[Alternate]+\dotfill
|\Name{SNNd}[Alternate]|\\
@@ -1190,296 +1389,327 @@ possible argument combinations work in most macros that take name arguments.
|\ForceFN\FName{SNNd}[Alternate]|
\end{quote}
+\subsection{Working with All Forms}
+
+\subsubsection{Index Names and Xrefs}
+
\begin{quote}
-\Verb+\IndexName[FNNe]{SNNe,Affix}[Alternate]+\dotfill
- |\IndexName[FNNe]{SNNe,Affix}[Alternate]|\\
-\Verb+\IndexName[FNNe]{SNNe,Affix}+\dotfill
- |\IndexName[FNNe]{SNNe,Affix}|\\
-\Verb+\IndexName{SNNf,Affix}[Alternate]+\dotfill
- |\IndexName{SNNf,Affix}[Alternate]|\\
-\Verb+\IndexName{SNNf,Affix}+\dotfill
- |\IndexName{SNNf,Affix}|\\
+\Verb+\IndexName[FNNe]{SNNe, Affix}[Alternate]+\dotfill
+ |\IndexName[FNNe]{SNNe, Affix}[Alternate]|\\
+\Verb+\IndexName[FNNe]{SNNe, Affix}+\dotfill
+ |\IndexName[FNNe]{SNNe, Affix}|\\
+\Verb+\IndexName{SNNf, Affix}[Alternate]+\dotfill
+ |\IndexName{SNNf, Affix}[Alternate]|\\
+\Verb+\IndexName{SNNf, Affix}+\dotfill
+ |\IndexName{SNNf, Affix}|\\
\Verb+\IndexName{SNNf}[Alternate]+\dotfill
|\IndexName{SNNf}[Alternate]|
\end{quote}
\begin{quote}
-\Verb+\IndexRef[FNNg]{SNNg,Affix}[Alternate]{Target}+\dotfill
- |\IndexRef[FNNg]{SNNg,Affix}[Alternate]{Target}|\\
-\Verb+\IndexRef[FNNg]{SNNg,Affix}{Target}+\dotfill
- |\IndexRef[FNNg]{SNNg,Affix}{Target}|\\
-\Verb+\IndexRef{SNNh,Affix}[Alternate]{Target}+\dotfill
- |\IndexRef{SNNh,Affix}[Alternate]{Target}|\\
-\Verb+\IndexRef{SNNh,Affix}{Target}+\dotfill
- |\IndexRef{SNNh,Affix}{Target}|\\
+\Verb+\IndexRef[FNNg]{SNNg, Affix}[Alternate]{Target}+\dotfill
+ |\IndexRef[FNNg]{SNNg, Affix}[Alternate]{Target}|\\
+\Verb+\IndexRef[FNNg]{SNNg, Affix}{Target}+\dotfill
+ |\IndexRef[FNNg]{SNNg, Affix}{Target}|\\
+\Verb+\IndexRef{SNNh, Affix}[Alternate]{Target}+\dotfill
+ |\IndexRef{SNNh, Affix}[Alternate]{Target}|\\
+\Verb+\IndexRef{SNNh, Affix}{Target}+\dotfill
+ |\IndexRef{SNNh, Affix}{Target}|\\
\Verb+\IndexRef{SNNh}[Alternate]{Target}+\dotfill
|\IndexRef{SNNh}[Alternate]{Target}|
\end{quote}
+\subsubsection{Excluding and Including}
+
\begin{quote}
-\Verb+\ExcludeName[FNNi]{SNNi,Affix}[Alternate]+\dotfill
- |\ExcludeName[FNNi]{SNNi,Affix}[Alternate]|\\
-\Verb+\ExcludeName[FNNi]{SNNi,Affix}+\dotfill
- |\ExcludeName[FNNi]{SNNi,Affix}|\\
-\Verb+\ExcludeName{SNNj,Affix}[Alternate]+\dotfill
- |\ExcludeName{SNNj,Affix}[Alternate]|\\
-\Verb+\ExcludeName{SNNj,Affix}+\dotfill
- |\ExcludeName{SNNj,Affix}|\\
+\Verb+\ExcludeName[FNNi]{SNNi, Affix}[Alternate]+\dotfill
+ |\ExcludeName[FNNi]{SNNi, Affix}[Alternate]|\\
+\Verb+\ExcludeName[FNNi]{SNNi, Affix}+\dotfill
+ |\ExcludeName[FNNi]{SNNi, Affix}|\\
+\Verb+\ExcludeName{SNNj, Affix}[Alternate]+\dotfill
+ |\ExcludeName{SNNj, Affix}[Alternate]|\\
+\Verb+\ExcludeName{SNNj, Affix}+\dotfill
+ |\ExcludeName{SNNj, Affix}|\\
\Verb+\ExcludeName{SNNj}[Alternate]+\dotfill
|\ExcludeName{SNNj}[Alternate]|
\end{quote}
\begin{quote}
-\Verb+\IncludeName[FNNi]{SNNi,Affix}[Alternate]+\dotfill
- |\IncludeName[FNNi]{SNNi,Affix}[Alternate]|\\
-\Verb+\IncludeName[FNNi]{SNNi,Affix}+\dotfill
- |\IncludeName[FNNi]{SNNi,Affix}|\\
-\Verb+\IncludeName{SNNj,Affix}[Alternate]+\dotfill
- |\IncludeName{SNNj,Affix}[Alternate]|\\
-\Verb+\IncludeName{SNNj,Affix}+\dotfill
- |\IncludeName{SNNj,Affix}|\\
+\Verb+\IncludeName[FNNi]{SNNi, Affix}[Alternate]+\dotfill
+ |\IncludeName[FNNi]{SNNi, Affix}[Alternate]|\\
+\Verb+\IncludeName[FNNi]{SNNi, Affix}+\dotfill
+ |\IncludeName[FNNi]{SNNi, Affix}|\\
+\Verb+\IncludeName{SNNj, Affix}[Alternate]+\dotfill
+ |\IncludeName{SNNj, Affix}[Alternate]|\\
+\Verb+\IncludeName{SNNj, Affix}+\dotfill
+ |\IncludeName{SNNj, Affix}|\\
\Verb+\IncludeName{SNNj}[Alternate]+\dotfill
|\IncludeName{SNNj}[Alternate]|
\end{quote}
\begin{quote}
-\Verb+\IncludeName*[FNNi]{SNNi,Affix}[Alternate]+\dotfill
- |\IncludeName*[FNNi]{SNNi,Affix}[Alternate]|\\
-\Verb+\IncludeName*[FNNi]{SNNi,Affix}+\dotfill
- |\IncludeName*[FNNi]{SNNi,Affix}|\\
-\Verb+\IncludeName*{SNNj,Affix}[Alternate]+\dotfill
- |\IncludeName*{SNNj,Affix}[Alternate]|\\
-\Verb+\IncludeName*{SNNj,Affix}+\dotfill
- |\IncludeName*{SNNj,Affix}|\\
+\Verb+\IncludeName*[FNNi]{SNNi, Affix}[Alternate]+\dotfill
+ |\IncludeName*[FNNi]{SNNi, Affix}[Alternate]|\\
+\Verb+\IncludeName*[FNNi]{SNNi, Affix}+\dotfill
+ |\IncludeName*[FNNi]{SNNi, Affix}|\\
+\Verb+\IncludeName*{SNNj, Affix}[Alternate]+\dotfill
+ |\IncludeName*{SNNj, Affix}[Alternate]|\\
+\Verb+\IncludeName*{SNNj, Affix}+\dotfill
+ |\IncludeName*{SNNj, Affix}|\\
\Verb+\IncludeName*{SNNj}[Alternate]+\dotfill
|\IncludeName*{SNNj}[Alternate]|
\end{quote}
+\subsubsection{Index Sorting}
+
\begin{quote}
-\Verb+\PretagName[FNNk]{SNNk,Affix}[Alternate]{Sorta}+\dotfill
- |\PretagName[FNNk]{SNNk,Affix}[Alternate]{Sorta}|\\
-\Verb+\PretagName[FNNl]{SNNl,Affix}{Sortb}+\dotfill
- |\PretagName[FNNl]{SNNl,Affix}{Sortb}|\\
-\Verb+\PretagName{SNNm,Affix}[Alternate]{Sortc}+\dotfill
- |\PretagName{SNNm,Affix}[Alternate]{Sortc}|\\
-\Verb+\PretagName{SNNn,Affix}{Sortd}+\dotfill
- |\PretagName{SNNn,Affix}{Sortd}|\\
+\Verb+\PretagName[FNNk]{SNNk, Affix}[Alternate]{Sorta}+\dotfill
+ |\PretagName[FNNk]{SNNk, Affix}[Alternate]{Sorta}|\\
+\Verb+\PretagName[FNNl]{SNNl, Affix}{Sortb}+\dotfill
+ |\PretagName[FNNl]{SNNl, Affix}{Sortb}|\\
+\Verb+\PretagName{SNNm, Affix}[Alternate]{Sortc}+\dotfill
+ |\PretagName{SNNm, Affix}[Alternate]{Sortc}|\\
+\Verb+\PretagName{SNNn, Affix}{Sortd}+\dotfill
+ |\PretagName{SNNn, Affix}{Sortd}|\\
\Verb+\PretagName{SNNo}[Alternate]{Sorte}+\dotfill
|\PretagName{SNNo}[Alternate]{Sorte}|
\end{quote}
+\subsubsection{Index Tagging and Untagging}
+
\begin{quote}
-\Verb+\TagName[FNNa]{SNNa,Affix}[Alternate]{Tag}+\dotfill
- |\TagName[FNNa]{SNNa,Affix}[Alternate]{Tag}|\\
-\Verb+\TagName[FNNa]{SNNa,Affix}{Tag}+\dotfill
- |\TagName[FNNa]{SNNa,Affix}{Tag}|\\
+\Verb+\TagName[FNNa]{SNNa, Affix}[Alternate]{Tag}+\dotfill
+ |\TagName[FNNa]{SNNa, Affix}[Alternate]{Tag}|\\
+\Verb+\TagName[FNNa]{SNNa, Affix}{Tag}+\dotfill
+ |\TagName[FNNa]{SNNa, Affix}{Tag}|\\
\Verb+\TagName[FNNb]{SNNb}[Alternate]{Tag}+\dotfill
|\TagName[FNNb]{SNNb}[Alternate]{Tag}|\\
\Verb+\TagName[FNNb]{SNNb}{Tag}+\dotfill
- |\TagName[FNNb]{SNNb,Affix}{Tag}|\\
-\Verb+\TagName{SNNc,Affix}[Alternate]{Tag}+\dotfill
- |\TagName{SNNc,Affix}[Alternate]{Tag}|\\
-\Verb+\TagName{SNNc,Affix}{Tag}+\dotfill
- |\TagName{SNNc,Affix}{Tag}|\\
+ |\TagName[FNNb]{SNNb, Affix}{Tag}|\\
+\Verb+\TagName{SNNc, Affix}[Alternate]{Tag}+\dotfill
+ |\TagName{SNNc, Affix}[Alternate]{Tag}|\\
+\Verb+\TagName{SNNc, Affix}{Tag}+\dotfill
+ |\TagName{SNNc, Affix}{Tag}|\\
\Verb+\TagName{SNNd}[Alternate]{Tag}+\dotfill
|\TagName{SNNd}[Alternate]{Tag}|
\end{quote}
\begin{quote}
-\Verb+\UntagName[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\UntagName[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\UntagName[FNNa]{SNNa,Affix}+\dotfill
- |\UntagName[FNNa]{SNNa,Affix}|\\
+\Verb+\UntagName[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\UntagName[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\UntagName[FNNa]{SNNa, Affix}+\dotfill
+ |\UntagName[FNNa]{SNNa, Affix}|\\
\Verb+\UntagName[FNNb]{SNNb}[Alternate]+\dotfill
|\UntagName[FNNb]{SNNb}[Alternate]|\\
\Verb+\UntagName[FNNb]{SNNb}+\dotfill
- |\UntagName[FNNb]{SNNb,Affix}|\\
-\Verb+\UntagName{SNNc,Affix}[Alternate]+\dotfill
- |\UntagName{SNNc,Affix}[Alternate]|\\
-\Verb+\UntagName{SNNc,Affix}+\dotfill
- |\UntagName{SNNc,Affix}|\\
+ |\UntagName[FNNb]{SNNb, Affix}|\\
+\Verb+\UntagName{SNNc, Affix}[Alternate]+\dotfill
+ |\UntagName{SNNc, Affix}[Alternate]|\\
+\Verb+\UntagName{SNNc, Affix}+\dotfill
+ |\UntagName{SNNc, Affix}|\\
\Verb+\UntagName{SNNd}[Alternate]+\dotfill
|\UntagName{SNNd}[Alternate]|
\end{quote}
+\subsubsection{Name Info}
+
\begin{quote}
-\Verb+\NameAddInfo[FNNa]{SNNa,Affix}[Alternate]{Info1}+\dotfill
- |\NameAddInfo[FNNa]{SNNa,Affixa}[Alternate]{Info1}|\\
-\Verb+\NameAddInfo[FNNa]{SNNa,Affix}{Info2}+\dotfill
- |\NameAddInfo[FNNa]{SNNa,Affix}{Info2}|\\
+\Verb+\NameAddInfo[FNNa]{SNNa, Affix}[Alternate]{Info1}+\dotfill
+ |\NameAddInfo[FNNa]{SNNa, Affixa}[Alternate]{Info1}|\\
+\Verb+\NameAddInfo[FNNa]{SNNa, Affix}{Info2}+\dotfill
+ |\NameAddInfo[FNNa]{SNNa, Affix}{Info2}|\\
\Verb+\NameAddInfo[FNNb]{SNNb}[Alternate]{Info3}+\dotfill
|\NameAddInfo[FNNb]{SNNb}[Alternate]{Info3}|\\
\Verb+\NameAddInfo[FNNb]{SNNb}{Info4}+\dotfill
|\NameAddInfo[FNNb]{SNNb}{Info4}|\\
-\Verb+\NameAddInfo{SNNc,Affix}[Alternate]{Info5}+\dotfill
- |\NameAddInfo{SNNc,Affix}[Alternate]{Info5}|\\
-\Verb+\NameAddInfo{SNNc,Affix}{Info6}+\dotfill
- |\NameAddInfo{SNNc,Affix}{Info6}|\\
+\Verb+\NameAddInfo{SNNc, Affix}[Alternate]{Info5}+\dotfill
+ |\NameAddInfo{SNNc, Affix}[Alternate]{Info5}|\\
+\Verb+\NameAddInfo{SNNc, Affix}{Info6}+\dotfill
+ |\NameAddInfo{SNNc, Affix}{Info6}|\\
\Verb+\NameAddInfo{SNNd}[Alternate]{Info7}+\dotfill
|\NameAddInfo{SNNd}[Alternate]{Info7}|
\end{quote}
\begin{quote}
-\Verb+\NameQueryInfo[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\NameQueryInfo[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\NameQueryInfo[FNNa]{SNNa,Affix}+\dotfill
- |\NameQueryInfo[FNNa]{SNNa,Affix}|\\
+\Verb+\NameQueryInfo[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\NameQueryInfo[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\NameQueryInfo[FNNa]{SNNa, Affix}+\dotfill
+ |\NameQueryInfo[FNNa]{SNNa, Affix}|\\
\Verb+\NameQueryInfo[FNNb]{SNNb}[Alternate]+\dotfill
|\NameQueryInfo[FNNb]{SNNb}[Alternate]|\\
\Verb+\NameQueryInfo[FNNb]{SNNb}+\dotfill
|\NameQueryInfo[FNNb]{SNNb}|\\
-\Verb+\NameQueryInfo{SNNc,Affix}[Alternate]+\dotfill
- |\NameQueryInfo{SNNc,Affix}[Alternate]|\\
-\Verb+\NameQueryInfo{SNNc,Affix}+\dotfill
- |\NameQueryInfo{SNNc,Affix}|\\
+\Verb+\NameQueryInfo{SNNc, Affix}[Alternate]+\dotfill
+ |\NameQueryInfo{SNNc, Affix}[Alternate]|\\
+\Verb+\NameQueryInfo{SNNc, Affix}+\dotfill
+ |\NameQueryInfo{SNNc, Affix}|\\
\Verb+\NameQueryInfo{SNNd}[Alternate]+\dotfill
|\NameQueryInfo{SNNd}[Alternate]|
\end{quote}
\begin{quote}
-\Verb+\NameClearInfo[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\NameClearInfo[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\NameClearInfo[FNNa]{SNNa,Affix}+\dotfill
- |\NameClearInfo[FNNa]{SNNa,Affix}|\\
+\Verb+\NameClearInfo[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\NameClearInfo[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\NameClearInfo[FNNa]{SNNa, Affix}+\dotfill
+ |\NameClearInfo[FNNa]{SNNa, Affix}|\\
\Verb+\NameClearInfo[FNNb]{SNNb}[Alternate]+\dotfill
|\NameClearInfo[FNNb]{SNNb}[Alternate]|\\
\Verb+\NameClearInfo[FNNb]{SNNb}+\dotfill
|\NameClearInfo[FNNb]{SNNb}|\\
-\Verb+\NameClearInfo{SNNc,Affix}[Alternate]+\dotfill
- |\NameClearInfo{SNNc,Affix}[Alternate]|\\
-\Verb+\NameClearInfo{SNNc,Affix}+\dotfill
- |\NameClearInfo{SNNc,Affix}|\\
+\Verb+\NameClearInfo{SNNc, Affix}[Alternate]+\dotfill
+ |\NameClearInfo{SNNc, Affix}[Alternate]|\\
+\Verb+\NameClearInfo{SNNc, Affix}+\dotfill
+ |\NameClearInfo{SNNc, Affix}|\\
\Verb+\NameClearInfo{SNNd}[Alternate]+\dotfill
|\NameClearInfo{SNNd}[Alternate]|
\end{quote}
+\subsubsection{Forgetting, Global}
+
\begin{quote}
-\Verb+\ForgetName[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\ForgetName[FNNa]{SNNa,Affix}[Alternate]|\\
-\Verb+\ForgetName[FNNa]{SNNa,Affix}+\dotfill
- |\ForgetName[FNNa]{SNNa,Affix}|\\
+\Verb+\ForgetName[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\ForgetName[FNNa]{SNNa, Affix}[Alternate]|\\
+\Verb+\ForgetName[FNNa]{SNNa, Affix}+\dotfill
+ |\ForgetName[FNNa]{SNNa, Affix}|\\
\Verb+\ForgetName[FNNb]{SNNb}[Alternate]+\dotfill
|\ForgetName[FNNb]{SNNb}[Alternate]|\\
\Verb+\ForgetName[FNNb]{SNNb}+\dotfill
|\ForgetName[FNNb]{SNNb}|\\
-\Verb+\ForgetName{SNNc,Affix}[Alternate]+\dotfill
- |\ForgetName{SNNc,Affix}[Alternate]|\\
-\Verb+\ForgetName{SNNc,Affix}+\dotfill
- |\ForgetName{SNNc,Affix}|\\
+\Verb+\ForgetName{SNNc, Affix}[Alternate]+\dotfill
+ |\ForgetName{SNNc, Affix}[Alternate]|\\
+\Verb+\ForgetName{SNNc, Affix}+\dotfill
+ |\ForgetName{SNNc, Affix}|\\
\Verb+\ForgetName{SNNd}[Alternate]+\dotfill
|\ForgetName{SNNd}[Alternate]|
\end{quote}
+\subsubsection{Subverting, Local}
+
\begin{quote}
\Verb+\LocalNames+\LocalNames\\
-\Verb+\SubvertName[FNNa]{SNNa,Affix}[Alternate]+\dotfill
- |\SubvertName[FNNa]{SNNa,Affix}[Alternate]|\\
+\Verb+\SubvertName[FNNa]{SNNa, Affix}[Alternate]+\dotfill
+ |\SubvertName[FNNa]{SNNa, Affix}[Alternate]|\\
\Verb+\SubvertName[FNNb]{SNNb}[Alternate]+\dotfill
|\SubvertName[FNNb]{SNNb}[Alternate]|\\
-\Verb+\SubvertName{SNNc,Affix}[Alternate]+\dotfill
- |\SubvertName{SNNc,Affix}[Alternate]|\\
+\Verb+\SubvertName{SNNc, Affix}[Alternate]+\dotfill
+ |\SubvertName{SNNc, Affix}[Alternate]|\\
\Verb+\SubvertName{SNNd}[Alternate]+\dotfill
|\SubvertName{SNNd}[Alternate]|\\
\Verb+\GlobalNames+\GlobalNames
\end{quote}
+\subsubsection{Name Conditionals}
+
\begin{quote}
-\Verb+\IfMainName[FNNa]{SNNa,Affix}{Y}{N}+\dotfill
- |\IfMainName[FNNa]{SNNa,Affix}{Y}{N}|\\
+\Verb+\IfMainName[FNNa]{SNNa, Affix}{Y}{N}+\dotfill
+ |\IfMainName[FNNa]{SNNa, Affix}{Y}{N}|\\
\Verb+\IfMainName[FNNb]{SNNb}{Y}{N}+\dotfill
|\IfMainName[FNNb]{SNNb}{Y}{N}|\\
-\Verb+\IfMainName{SNNc,Affix}{Y}{N}+\dotfill
- |\IfMainName{SNNc,Affix}{Y}{N}|\\
+\Verb+\IfMainName{SNNc, Affix}{Y}{N}+\dotfill
+ |\IfMainName{SNNc, Affix}{Y}{N}|\\
\Verb+\IfMainName{SNNd}[Alternate]{Y}{N}+\dotfill
|\IfMainName{SNNd}[Alternate]{Y}{N}|
\end{quote}
\begin{quote}
-\Verb+\IfFrontName[FNNa]{SNNa,Affix}[Alternate]{Y}{N}+\dotfill
- |\IfFrontName[FNNa]{SNNa,Affix}[Alternate]{Y}{N}|\\
+\Verb+\IfFrontName[FNNa]{SNNa, Affix}[Alternate]{Y}{N}+\dotfill
+ |\IfFrontName[FNNa]{SNNa, Affix}[Alternate]{Y}{N}|\\
\Verb+\IfFrontName[FNNb]{SNNb}[Alternate]{Y}{N}+\dotfill
|\IfFrontName[FNNb]{SNNb}[Alternate]{Y}{N}|\\
-\Verb+\IfFrontName{SNNc,Affix}[Alternate]{Y}{N}+\dotfill
- |\IfFrontName{SNNc,Affix}[Alternate]{Y}{N}|\\
+\Verb+\IfFrontName{SNNc, Affix}[Alternate]{Y}{N}+\dotfill
+ |\IfFrontName{SNNc, Affix}[Alternate]{Y}{N}|\\
\Verb+\IfFrontName{SNNd}[Alternate]{Y}{N}+\dotfill
|\IfFrontName{SNNd}[Alternate]{Y}{N}|
\end{quote}
\begin{quote}
-\Verb+\SeeAlso\IndexRef[FNNp]{SNNp,Affix}{Target}+\dotfill
- |\SeeAlso\IndexRef[FNNp]{SNNp,Affix}{Target}|\\
-\Verb+\ExcludeName{SNNq,Affix}+\dotfill
- |\ExcludeName{SNNq,Affix}|\\
-\Verb+\IfAKA[FNNp]{SNNp,Affix}[Alternate]{Y}{N}{X}+\dotfill
- |\IfAKA[FNNp]{SNNp,Affix}[Alternate]{Y}{N}{X}|\\
-\Verb+\IfAKA[FNNp]{SNNp,Affix}{Y}{N}{X}+\dotfill
- |\IfAKA[FNNp]{SNNp,Affix}{Y}{N}{X}|\\
-\Verb+\IfAKA{SNNq,Affix}[Alternate]{Y}{N}{X}+\dotfill
- |\IfAKA{SNNq,Affix}[Alternate]{Y}{N}{X}|\\
-\Verb+\IfAKA{SNNq,Affix}{Y}{N}{X}+\dotfill
- |\IfAKA{SNNq,Affix}{Y}{N}{X}|\\
+\Verb+\SeeAlso\IndexRef[FNNp]{SNNp, Affix}{Target}+\dotfill
+ |\SeeAlso\IndexRef[FNNp]{SNNp, Affix}{Target}|\\
+\Verb+\ExcludeName{SNNq, Affix}+\dotfill
+ |\ExcludeName{SNNq, Affix}|\\
+\Verb+\IfAKA[FNNp]{SNNp, Affix}[Alternate]{Y}{N}{X}+\dotfill
+ |\IfAKA[FNNp]{SNNp, Affix}[Alternate]{Y}{N}{X}|\\
+\Verb+\IfAKA[FNNp]{SNNp, Affix}{Y}{N}{X}+\dotfill
+ |\IfAKA[FNNp]{SNNp, Affix}{Y}{N}{X}|\\
+\Verb+\IfAKA{SNNq, Affix}[Alternate]{Y}{N}{X}+\dotfill
+ |\IfAKA{SNNq, Affix}[Alternate]{Y}{N}{X}|\\
+\Verb+\IfAKA{SNNq, Affix}{Y}{N}{X}+\dotfill
+ |\IfAKA{SNNq, Affix}{Y}{N}{X}|\\
\Verb+\IfAKA{SNNr}[Alternate]{Y}{N}{X}+\dotfill
|\IfAKA{SNNr}[Alternate]{Y}{N}{X}|
\end{quote}
+\subsubsection{Pseudonym Syntax: The Horror}
+
+\begin{quote}
+\Verb+\AKA[FNN1]{SNN1, Affix1}%+\\
+\Verb+ [FNN2]{SNN2, Affix2}[Alternate2]+\dotfill
+ |\AKA[FNN1]{SNN1, Affix1}[FNN2]{SNN2, Affix2}[Alternate2]|\\
+\Verb+\AKA[FNN1]{SNN1, Affix1}%+\\
+\Verb+ [FNN2]{SNN2, Affix2}+\dotfill
+ |\AKA[FNN1]{SNN1, Affix1}[FNN2]{SNN2, Affix2}|\\
+\Verb+\DropAffix\AKA[FNN1]{SNN1, Affix1}%+\\
+\Verb+ [FNN2]{SNN2, Affix2}+\dotfill
+ |\DropAffix\AKA[FNN1]{SNN1, Affix1}[FNN2]{SNN2, Affix2}|\\
+\Verb+\AKA*[FNN1]{SNN1, Affix1}%+\\
+\Verb+ [FNN2]{SNN2, Affix2}[Alternate2]+\dotfill
+ |\AKA*[FNN1]{SNN1, Affix1}[FNN2]{SNN2, Affix2}[Alternate2]|\\
+\Verb+\AKA*[FNN1]{SNN1, Affix1}%+\\
+\Verb+ [FNN2]{SNN2, Affix2}+\dotfill
+ |\AKA*[FNN1]{SNN1, Affix1}[FNN2]{SNN2, Affix2}|
+\end{quote}
+
\begin{quote}
-\Verb+\AKA[FNN1]{SNN1,Affix1}%+\\
-\Verb+ [FNN2]{SNN2,Affix2}[Alternate2]+\dotfill
- |\AKA[FNN1]{SNN1,Affix1}[FNN2]{SNN2,Affix2}[Alternate2]|\\
-\Verb+\AKA[FNN1]{SNN1,Affix1}%+\\
-\Verb+ [FNN2]{SNN2,Affix2}+\dotfill
- |\AKA[FNN1]{SNN1,Affix1}[FNN2]{SNN2,Affix2}|\\
-\Verb+\DropAffix\AKA[FNN1]{SNN1,Affix1}%+\\
-\Verb+ [FNN2]{SNN2,Affix2}+\dotfill
- |\DropAffix\AKA[FNN1]{SNN1,Affix1}[FNN2]{SNN2,Affix2}|\\
-\Verb+\AKA*[FNN1]{SNN1,Affix1}%+\\
-\Verb+ [FNN2]{SNN2,Affix2}[Alternate2]+\dotfill
- |\AKA*[FNN1]{SNN1,Affix1}[FNN2]{SNN2,Affix2}[Alternate2]|\\
-\Verb+\AKA*[FNN1]{SNN1,Affix1}%+\\
-\Verb+ [FNN2]{SNN2,Affix2}+\dotfill
- |\AKA*[FNN1]{SNN1,Affix1}[FNN2]{SNN2,Affix2}|
+\Verb+\AKA[FNN1]{SNN1, Affix1}%+\\
+\Verb+ {SNN3, Affix3}[Alternate3]+\dotfill
+ |\AKA[FNN1]{SNN1, Affix1}{SNN3, Affix3}[Alternate3]|\\
+\Verb+\AKA[FNN1]{SNN1, Affix1}%+\\
+\Verb+ {SNN3, Affix3}+\dotfill
+ |\AKA[FNN1]{SNN1, Affix1}{SNN3, Affix3}|\\
+\Verb+\AKA*[FNN1]{SNN1, Affix1}%+\\
+\Verb+ {SNN3, Affix3}+\dotfill
+ |\AKA*[FNN1]{SNN1, Affix1}{SNN3, Affix3}|\\
+\Verb+\ForceFN\AKA*[FNN1]{SNN1, Affix1}%+\\
+\Verb+ {SNN3, Affix3}[Alternate3]+\dotfill
+ |\ForceFN\AKA*[FNN1]{SNN1, Affix1}{SNN3, Affix3}[Alternate3]|\\
+\Verb+\ForceFN\AKA*[FNN1]{SNN1, Affix1}%+\\
+\Verb+ {SNN3, Affix3}+\dotfill
+ |\ForceFN\AKA*[FNN1]{SNN1, Affix1}{SNN3, Affix3}|
\end{quote}
\begin{quote}
-\Verb+\AKA[FNN1]{SNN1,Affix1}%+\\
-\Verb+ {SNN3,Affix3}[Alternate3]+\dotfill
- |\AKA[FNN1]{SNN1,Affix1}{SNN3,Affix3}[Alternate3]|\\
-\Verb+\AKA[FNN1]{SNN1,Affix1}%+\\
-\Verb+ {SNN3,Affix3}+\dotfill
- |\AKA[FNN1]{SNN1,Affix1}{SNN3,Affix3}|\\
-\Verb+\AKA*[FNN1]{SNN1,Affix1}%+\\
-\Verb+ {SNN3,Affix3}+\dotfill
- |\AKA*[FNN1]{SNN1,Affix1}{SNN3,Affix3}|\\
-\Verb+\ForceFN\AKA*[FNN1]{SNN1,Affix1}%+\\
-\Verb+ {SNN3,Affix3}[Alternate3]+\dotfill
- |\ForceFN\AKA*[FNN1]{SNN1,Affix1}{SNN3,Affix3}[Alternate3]|\\
-\Verb+\ForceFN\AKA*[FNN1]{SNN1,Affix1}%+\\
-\Verb+ {SNN3,Affix3}+\dotfill
- |\ForceFN\AKA*[FNN1]{SNN1,Affix1}{SNN3,Affix3}|
+\Verb+\AKA[FNN1]{SNN1, Affix1}{SNN4}[Alternate4]+\dotfill
+ |\AKA[FNN1]{SNN1, Affix1}{SNN4}[Alternate4]|\\
+\Verb+\AKA*[FNN1]{SNN1, Affix1}{SNN4}[Alternate4]+\dotfill
+ |\AKA*[FNN1]{SNN1, Affix1}{SNN4}[Alternate4]|\\
+\Verb+\ForceFN\AKA*[FNN1]{SNN1, Affix1}{SNN4}[Alternate4]+\dotfill
+ |\ForceFN\AKA*[FNN1]{SNN1, Affix1}{SNN4}[Alternate4]|
\end{quote}
\begin{quote}
-\Verb+\AKA[FNN1]{SNN1,Affix1}{SNN4}[Alternate4]+\dotfill
- |\AKA[FNN1]{SNN1,Affix1}{SNN4}[Alternate4]|\\
-\Verb+\AKA*[FNN1]{SNN1,Affix1}{SNN4}[Alternate4]+\dotfill
- |\AKA*[FNN1]{SNN1,Affix1}{SNN4}[Alternate4]|\\
-\Verb+\ForceFN\AKA*[FNN1]{SNN1,Affix1}{SNN4}[Alternate4]+\dotfill
- |\ForceFN\AKA*[FNN1]{SNN1,Affix1}{SNN4}[Alternate4]|
+\Verb+\AKA{SNN5, Affix5}%+\\
+\Verb+ [FNN6]{SNN6, Affix6}[Alternate6]+\dotfill
+ |\AKA{SNN5, Affix5}[FNN6]{SNN6, Affix6}[Alternate6]|\\
+\Verb+\AKA{SNN5, Affix5}{SNN7, Affix7}+\dotfill
+ |\AKA{SNN5, Affix5}{SNN7, Affix7}|\\
+\Verb+\AKA{SNN5, Affix5}{SNN8}[Alternate8]+\dotfill
+ |\AKA{SNN5, Affix5}{SNN8}[Alternate8]|\\
\end{quote}
+\subsection{Reference Targets for Completeness}
+
\begin{quote}
-\Verb+\AKA{SNN5,Affix5}%+\\
-\Verb+ [FNN6]{SNN6,Affix6}[Alternate6]+\dotfill
- |\AKA{SNN5,Affix5}[FNN6]{SNN6,Affix6}[Alternate6]|\\
-\Verb+\AKA{SNN5,Affix5}{SNN7,Affix7}+\dotfill
- |\AKA{SNN5,Affix5}{SNN7,Affix7}|\\
-\Verb+\AKA{SNN5,Affix5}{SNN8}[Alternate8]+\dotfill
- |\AKA{SNN5,Affix5}{SNN8}[Alternate8]|\\
+\Verb+\IndexName{Target}+\dotfill|\IndexName{Target}|\\
+\Verb+\IndexName[FNN1]{SNN1, Affix1}+\dotfill
+ |\IndexName[FNN1]{SNN1, Affix1}|\\
+\Verb+\IndexName{SNN5, Affix5}+\dotfill
+ |\IndexName{SNN5, Affix5}|
\end{quote}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
+
\phantomsection
\addcontentsline{toc}{section}{Index of Persons}
\printindex[per]
diff --git a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
index 0fa566fad64..139e62f414d 100644
--- a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
+++ b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
Binary files differ