summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/nameauth
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-02-28 03:01:24 +0000
committerNorbert Preining <norbert@preining.info>2021-02-28 03:01:24 +0000
commit189140b53960215eec1626503040fb38360ab4ed (patch)
treee7551ffd51e263ef259dcd95668d5b35377590cd /macros/latex/contrib/nameauth
parent4e6fb7c03bc033485887a99d2ffeca70ef8c0644 (diff)
CTAN sync 202102280301
Diffstat (limited to 'macros/latex/contrib/nameauth')
-rw-r--r--macros/latex/contrib/nameauth/Makefile20
-rw-r--r--macros/latex/contrib/nameauth/README.md71
-rw-r--r--macros/latex/contrib/nameauth/examples.tex8
-rw-r--r--macros/latex/contrib/nameauth/nameauth.dtx88
-rw-r--r--macros/latex/contrib/nameauth/nameauth.pdfbin1144403 -> 1144677 bytes
5 files changed, 106 insertions, 81 deletions
diff --git a/macros/latex/contrib/nameauth/Makefile b/macros/latex/contrib/nameauth/Makefile
index d2a47efb83..ffd7d76e94 100644
--- a/macros/latex/contrib/nameauth/Makefile
+++ b/macros/latex/contrib/nameauth/Makefile
@@ -46,7 +46,7 @@ examples.pdf : examples.tex
if [ -f examples.out.ps ]; then rm examples.out.ps; fi
#
# This is the recipe for the package docs. It will work also for dvi output.
-$(NAME).pdf : $(NAME).dtx
+$(NAME).pdf : $(NAME).dtx nameauth.sty nameauth.ins
$(ENGINE) -shell-escape -recorder -interaction=batchmode $(NAME).dtx >/dev/null
$(ENGINE) --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
if [ -f $(NAME).glo ]; then makeindex -q -s gglo.ist -o $(NAME).gls $(NAME).glo; fi
@@ -55,6 +55,24 @@ $(NAME).pdf : $(NAME).dtx
$(ENGINE) --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
if [ -f $(NAME).dvi ]; then dvipdf $(NAME); fi
#
+# These are the recipes for all the files that need to be extracted
+# from the dtx file. Any one of them simply extracts the following:
+# README.md, nameauth.ins, nameauth.sty, examples.tex
+#
+# Once any one of these recipes is run, the rest will be satisfied.
+# But they need to be there for dependencies to work best.
+README.md : $(NAME).dtx
+ pdftex $(NAME).dtx
+
+nameauth.ins : $(NAME).dtx
+ pdftex $(NAME).dtx
+
+nameauth.sty : $(NAME).dtx
+ pdftex $(NAME).dtx
+
+examples.tex : $(NAME).dtx
+ pdftex $(NAME).dtx
+#
# Using this recipe deletes the auxiliary and log files
clean:
rm -f $(NAME).{aux,fls,glo,gls,hd,idx,ilg,ind,ins,log,out,toc}
diff --git a/macros/latex/contrib/nameauth/README.md b/macros/latex/contrib/nameauth/README.md
index 2ea1c5952b..0ae72377ac 100644
--- a/macros/latex/contrib/nameauth/README.md
+++ b/macros/latex/contrib/nameauth/README.md
@@ -11,15 +11,16 @@ editing process without needing to retype name references.
|`nameauth.dtx`|commented style file; source file |
|`Makefile` |For use with GNU make; with source file|
|`nameauth.ins`|installation driver (generated file) |
-|`nameauth.pdf`|Documentation (generated file) |
-|`README.md` |This file (generated file) |
-|`examples.tex`|example macros (generated file) |
+|`nameauth.sty`|style file (generated file) |
+|`nameauth.pdf`|Documentation (generated file) |
+|`README.md` |This file (generated file) |
+|`examples.tex`|example macros (generated file) |
# Obtaining the Package
1. Packaged in your current TeX distrbution: See the appropriate documentation.
-2. Otherwise, download `nameauth.zip` from [CTAN](www.ctan.org/tex-archive/macros/latex/contrib/nameauth).
+2. Otherwise, download `nameauth.zip` from [CTAN](http://mirrors.ctan.org/macros/latex/contrib/nameauth.zip).
3. Unpack `nameauth.zip` in an appropriate directory.
@@ -31,54 +32,56 @@ editing process without needing to retype name references.
This method requires GNU `make` on a POSIX-compliant environment, such as GNU/Linux, various BSD flavors, perhaps MacOS (e.g., with various porting systems), and even Cygwin on Windows.
-0. A quick install in one's home directory using some of the included files from the `zip` archive just requires the following steps:
+ * We use the LaTeX installation on the host machine to build the package. When using `make`, any `dvi` files that are created will also be converted to `pdf` format.
- tex nameauth.dtx
- make inst
+1. Type `make` to generate the release files using `pdflatex`.
-Otherwise we use the LaTeX installation on the host machine to build the package. When using `make`, any `dvi` files that are created will also be converted to `pdf` format.
+2. To use another LaTeX engine, type one of the following:
-1. Type `make distclean release` to generate the release files using `pdflatex`.
-
-2. To use another TeX engine, type one of the following:
- make ENGINE=latex
+ make ENGINE=xelatex
make ENGINE=lualatex
make ENGINE=dvilualatex
- make ENGINE=xelatex
+ make ENGINE=latex
3. Type `make inst` to install the files in the user's personal TDS-compliant directory tree.
4. Type `sudo make install` to install the files in the system-wide, local TDS-compliant directory tree.
+5. One can include multiple make targets on the command line, but that goes beyond the scope of this document and is intended for experienced users.
+
## Manual Compilation
Otherwise, the following steps are used for manual installation. See the general information at the [TeX FAQ](https://www.texfaq.org/FAQ-installthings).
-0. To use some of the included files from the `zip` archive and only extract files from the `dtx` file, just do the following step and proceed to installation:
-
- tex nameauth.dtx
-
1. To build the package on the host system, generate the installation files and a copy of the documentation without the table of contents and cross-references. We use `pdflatex` by default:
pdflatex --shell-escape --recorder --interaction=batchmode nameauth.dtx
-2. Generate the TOC and cross-references for the documentation:
+2. This will generate the following files:
+
+ nameauth.ins (complete)
+ nameauth.sty (complete)
+ nameauth.pdf (incomplete; do steps 3 through 5)
+ README.md (complete)
+ examples.tex (complete)
+
+3. Generate the TOC and cross-references for the documentation:
pdflatex --recorder --interaction=nonstopmode nameauth.dtx
-3. Generate the index files using `makeindex`:
+4. Generate the index files using `makeindex`:
makeindex -q -s gglo.ist -o nameauth.gls nameauth.glo
makeindex -q -s gind.ist -o nameauth.ind nameauth.idx
-4. Integrate the glossary (changes) and index into the documentation. The second run updates the TOC:
+5. Integrate the glossary (changes) and index into the documentation. The second run updates the TOC:
pdflatex --recorder --interaction=nonstopmode nameauth.dtx
pdflatex --recorder --interaction=nonstopmode nameauth.dtx
-One can substitute, e.g., `latex`, `xelatex`, `lualatex`, and `dvilualatex` for `pdflatex`, but the documentation may look different in some cases.
+One can substitute, e.g., `xelatex`, `lualatex`, `dvilualatex`, and `latex`, for `pdflatex`, but the documentation may look different in some cases.
-## File Installation
+## Manual File Installation
Different TeX distributions have somewhat different ways to store TDS-compliant configuration and package data. See, for example, [MikTeX](https://miktex.org/kb/texmf-roots) and the [TeX FAQ](https://www.texfaq.org/FAQ-privinst). Two approaches below conform generally to a Unix-based system:
@@ -86,11 +89,11 @@ Different TeX distributions have somewhat different ways to store TDS-compliant
`TEXMFHOME` is a variable that points to the root of a TDS-compliant directory tree available to a user. Use `kpsewhich --var-value TEXMFHOME` to obtain its value. Quite often it is equivalent to `$HOME/texmf`. The dollar sign in front of the variable denotes the value of the variable instead of its name. So if `$HOME` is `/home/bob`, then `$TEXMFHOME` would be `/home/bob/texmf`, and we can understand the following paths to be under that directory:
-|Path |Description |
-|----------------------------------|---------------------------------------|
-|`$TEXMFHOME/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
-|`$TEXMFHOME/tex/latex/nameauth` |`sty` file |
-|`$TEXMFHOME/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex`|
+|Path |Description |
+|----------------------------------|----------------------------------------|
+|`$TEXMFHOME/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
+|`$TEXMFHOME/tex/latex/nameauth` |`sty` file |
+|`$TEXMFHOME/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex` |
On older TeX distributions, run `mktexlsr` on $TEXMFHOME to complete the install process.
@@ -98,11 +101,11 @@ On older TeX distributions, run `mktexlsr` on $TEXMFHOME to complete the install
`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. Use `kpsewhich --var-value TEXMFLOCAL` to obtain its value. See the [TeX FAQ](https://www.texfaq.org/FAQ-what-TDS). We can understand the following paths to be under that directory:
-|Path |Description |
-|-----------------------------------|---------------------------------------|
-|`$TEXMFLOCAL/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
-|`$TEXMFLOCAL/tex/latex/nameauth` |`sty` file |
-|`$TEXMFLOCAL/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex`|
+|Path |Description |
+|-----------------------------------|----------------------------------------|
+|`$TEXMFLOCAL/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
+|`$TEXMFLOCAL/tex/latex/nameauth` |`sty` file |
+|`$TEXMFLOCAL/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex` |
Run `mktexlsr` with the appropriate permissions on `$TEXMFLOCAL` to complete the install process.
@@ -141,7 +144,7 @@ The manual is also a test suite.
# Copyright
-Copyright (C) 2020 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+Copyright (C) 2021 by Charles P. Schaum <charles[dot]schaum@comcast.net>
-------------------------------------------------------
This file may be distributed and/or modified under the
@@ -149,7 +152,7 @@ conditions of the LaTeX Project Public License, either version 1.3
of this license or (at your option) any later version.
The latest version of this license is in:
- [http://www.latex-project.org/lppl.txt](http://www.latex-project.org/lppl.txt)
+ [http://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.
diff --git a/macros/latex/contrib/nameauth/examples.tex b/macros/latex/contrib/nameauth/examples.tex
index c9e41e6eab..c7c6fabb86 100644
--- a/macros/latex/contrib/nameauth/examples.tex
+++ b/macros/latex/contrib/nameauth/examples.tex
@@ -8,14 +8,14 @@
%%
%% This is a generated file.
%%
-%% Copyright (C) 2020 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+%% Copyright (C) 2021 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:
%%
-%% http://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.
@@ -74,7 +74,7 @@
\usepackage{booktabs}
\usepackage{colortbl}
\usepackage{index}
-\usepackage{nameauth}[2020/11/23]
+\usepackage{nameauth}[2021/02/27]
\usepackage{verbatim}
\usepackage{xcolor}
\colorlet{grey}{black!7!white}
@@ -236,7 +236,7 @@
\ClearNum
\title{\bfseries Longer Examples}
\author{Charles P. Schaum}
-\date{2020/11/23}
+\date{2021/02/27}
\begin{document}
\maketitle
diff --git a/macros/latex/contrib/nameauth/nameauth.dtx b/macros/latex/contrib/nameauth/nameauth.dtx
index 5a9d1ad126..f755e23dd3 100644
--- a/macros/latex/contrib/nameauth/nameauth.dtx
+++ b/macros/latex/contrib/nameauth/nameauth.dtx
@@ -1,6 +1,6 @@
% \iffalse meta-comment
%
-% Copyright (C) 2020 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+% Copyright (C) 2021 by Charles P. Schaum <charles[dot]schaum@comcast.net>
% -------------------------------------------------------
%
% This file may be distributed and/or modified under the
@@ -8,7 +8,7 @@
% of this license or (at your option) any later version.
% The latest version of this license is in:
%
-% http://www.latex-project.org/lppl.txt
+% 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.
@@ -31,15 +31,16 @@ editing process without needing to retype name references.
|`nameauth.dtx`|commented style file; source file |
|`Makefile` |For use with GNU make; with source file|
|`nameauth.ins`|installation driver (generated file) |
-|`nameauth.pdf`|Documentation (generated file) |
-|`README.md` |This file (generated file) |
-|`examples.tex`|example macros (generated file) |
+|`nameauth.sty`|style file (generated file) |
+|`nameauth.pdf`|Documentation (generated file) |
+|`README.md` |This file (generated file) |
+|`examples.tex`|example macros (generated file) |
# Obtaining the Package
1. Packaged in your current TeX distrbution: See the appropriate documentation.
-2. Otherwise, download `nameauth.zip` from [CTAN](www.ctan.org/tex-archive/macros/latex/contrib/nameauth).
+2. Otherwise, download `nameauth.zip` from [CTAN](http://mirrors.ctan.org/macros/latex/contrib/nameauth.zip).
3. Unpack `nameauth.zip` in an appropriate directory.
@@ -51,54 +52,56 @@ editing process without needing to retype name references.
This method requires GNU `make` on a POSIX-compliant environment, such as GNU/Linux, various BSD flavors, perhaps MacOS (e.g., with various porting systems), and even Cygwin on Windows.
-0. A quick install in one's home directory using some of the included files from the `zip` archive just requires the following steps:
+ * We use the LaTeX installation on the host machine to build the package. When using `make`, any `dvi` files that are created will also be converted to `pdf` format.
- tex nameauth.dtx
- make inst
+1. Type `make` to generate the release files using `pdflatex`.
-Otherwise we use the LaTeX installation on the host machine to build the package. When using `make`, any `dvi` files that are created will also be converted to `pdf` format.
+2. To use another LaTeX engine, type one of the following:
-1. Type `make distclean release` to generate the release files using `pdflatex`.
-
-2. To use another TeX engine, type one of the following:
- make ENGINE=latex
+ make ENGINE=xelatex
make ENGINE=lualatex
make ENGINE=dvilualatex
- make ENGINE=xelatex
+ make ENGINE=latex
3. Type `make inst` to install the files in the user's personal TDS-compliant directory tree.
4. Type `sudo make install` to install the files in the system-wide, local TDS-compliant directory tree.
+5. One can include multiple make targets on the command line, but that goes beyond the scope of this document and is intended for experienced users.
+
## Manual Compilation
Otherwise, the following steps are used for manual installation. See the general information at the [TeX FAQ](https://www.texfaq.org/FAQ-installthings).
-0. To use some of the included files from the `zip` archive and only extract files from the `dtx` file, just do the following step and proceed to installation:
-
- tex nameauth.dtx
-
1. To build the package on the host system, generate the installation files and a copy of the documentation without the table of contents and cross-references. We use `pdflatex` by default:
pdflatex --shell-escape --recorder --interaction=batchmode nameauth.dtx
-2. Generate the TOC and cross-references for the documentation:
+2. This will generate the following files:
+
+ nameauth.ins (complete)
+ nameauth.sty (complete)
+ nameauth.pdf (incomplete; do steps 3 through 5)
+ README.md (complete)
+ examples.tex (complete)
+
+3. Generate the TOC and cross-references for the documentation:
pdflatex --recorder --interaction=nonstopmode nameauth.dtx
-3. Generate the index files using `makeindex`:
+4. Generate the index files using `makeindex`:
makeindex -q -s gglo.ist -o nameauth.gls nameauth.glo
makeindex -q -s gind.ist -o nameauth.ind nameauth.idx
-4. Integrate the glossary (changes) and index into the documentation. The second run updates the TOC:
+5. Integrate the glossary (changes) and index into the documentation. The second run updates the TOC:
pdflatex --recorder --interaction=nonstopmode nameauth.dtx
pdflatex --recorder --interaction=nonstopmode nameauth.dtx
-One can substitute, e.g., `latex`, `xelatex`, `lualatex`, and `dvilualatex` for `pdflatex`, but the documentation may look different in some cases.
+One can substitute, e.g., `xelatex`, `lualatex`, `dvilualatex`, and `latex`, for `pdflatex`, but the documentation may look different in some cases.
-## File Installation
+## Manual File Installation
Different TeX distributions have somewhat different ways to store TDS-compliant configuration and package data. See, for example, [MikTeX](https://miktex.org/kb/texmf-roots) and the [TeX FAQ](https://www.texfaq.org/FAQ-privinst). Two approaches below conform generally to a Unix-based system:
@@ -106,11 +109,11 @@ Different TeX distributions have somewhat different ways to store TDS-compliant
`TEXMFHOME` is a variable that points to the root of a TDS-compliant directory tree available to a user. Use `kpsewhich --var-value TEXMFHOME` to obtain its value. Quite often it is equivalent to `$HOME/texmf`. The dollar sign in front of the variable denotes the value of the variable instead of its name. So if `$HOME` is `/home/bob`, then `$TEXMFHOME` would be `/home/bob/texmf`, and we can understand the following paths to be under that directory:
-|Path |Description |
-|----------------------------------|---------------------------------------|
-|`$TEXMFHOME/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
-|`$TEXMFHOME/tex/latex/nameauth` |`sty` file |
-|`$TEXMFHOME/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex`|
+|Path |Description |
+|----------------------------------|----------------------------------------|
+|`$TEXMFHOME/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
+|`$TEXMFHOME/tex/latex/nameauth` |`sty` file |
+|`$TEXMFHOME/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex` |
On older TeX distributions, run `mktexlsr` on $TEXMFHOME to complete the install process.
@@ -118,11 +121,11 @@ On older TeX distributions, run `mktexlsr` on $TEXMFHOME to complete the install
`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. Use `kpsewhich --var-value TEXMFLOCAL` to obtain its value. See the [TeX FAQ](https://www.texfaq.org/FAQ-what-TDS). We can understand the following paths to be under that directory:
-|Path |Description |
-|-----------------------------------|---------------------------------------|
-|`$TEXMFLOCAL/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
-|`$TEXMFLOCAL/tex/latex/nameauth` |`sty` file |
-|`$TEXMFLOCAL/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex`|
+|Path |Description |
+|-----------------------------------|----------------------------------------|
+|`$TEXMFLOCAL/source/latex/nameauth`|`ins` and `dtx` files, Makefile |
+|`$TEXMFLOCAL/tex/latex/nameauth` |`sty` file |
+|`$TEXMFLOCAL/doc/latex/nameauth` |`pdf` file, `README.md`, `examples.tex` |
Run `mktexlsr` with the appropriate permissions on `$TEXMFLOCAL` to complete the install process.
@@ -161,7 +164,7 @@ The manual is also a test suite.
# Copyright
-Copyright (C) 2020 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+Copyright (C) 2021 by Charles P. Schaum <charles[dot]schaum@comcast.net>
-------------------------------------------------------
This file may be distributed and/or modified under the
@@ -169,7 +172,7 @@ conditions of the LaTeX Project Public License, either version 1.3
of this license or (at your option) any later version.
The latest version of this license is in:
- [http://www.latex-project.org/lppl.txt](http://www.latex-project.org/lppl.txt)
+ [http://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.
@@ -191,14 +194,14 @@ version 2005/12/01 or later.
This is a generated file.
-Copyright (C) 2020 by Charles P. Schaum <charles[dot]schaum@comcast.net>
+Copyright (C) 2021 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:
- http://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.
@@ -240,7 +243,7 @@ and version 1.3 or later is part of all distributions of LaTeX version
%<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01]
%<package>\ProvidesPackage{nameauth}
%<*package>
- [2020/11/23 3.5 Name authority mechanism for consistency in text and index]
+ [2021/02/27 3.6 Name authority mechanism for consistency in text and index]
%</package>
%
%<*driver>
@@ -310,7 +313,7 @@ and version 1.3 or later is part of all distributions of LaTeX version
right=25mm,marginparwidth=39mm,nohead]{geometry}
%^^A Include specifically the current version of the package.
-\usepackage{\jobname}[2020/11/23]
+\usepackage{\jobname}[2021/02/27]
%^^A Set up all tabular packages. Booktabs makes them pretty,
%^^A colortabl shades rows, and tabularx allows some fiddly
@@ -653,6 +656,7 @@ and version 1.3 or later is part of all distributions of LaTeX version
% \changes{3.2}{2017/03/22}{Root, suffix macros renamed, redesigned}
% \changes{3.4}{2020/02/26}{Update manual, \texttt{examples.tex}}
% \changes{3.5}{2020/11/23}{Updates to manual, \texttt{Readme.md}, \texttt{Makefile}, \texttt{examples.tex}, combine \texttt{Readme.md} and \texttt{examples.tex} files in \texttt{dtx}}
+% \changes{3.6}{2021/02/27}{Updates to \texttt{Readme.md}, \texttt{Makefile}}
%
% \GetFileInfo{\jobname.dtx}
%
@@ -9414,7 +9418,7 @@ and version 1.3 or later is part of all distributions of LaTeX version
\usepackage{booktabs}
\usepackage{colortbl}
\usepackage{index}
-\usepackage{nameauth}[2020/11/23]
+\usepackage{nameauth}[2021/02/27]
\usepackage{verbatim}
\usepackage{xcolor}
\colorlet{grey}{black!7!white}
@@ -9576,7 +9580,7 @@ and version 1.3 or later is part of all distributions of LaTeX version
\ClearNum
\title{\bfseries Longer Examples}
\author{Charles P. Schaum}
-\date{2020/11/23}
+\date{2021/02/27}
\begin{document}
\maketitle
diff --git a/macros/latex/contrib/nameauth/nameauth.pdf b/macros/latex/contrib/nameauth/nameauth.pdf
index 63ce4add2a..2f290222c7 100644
--- a/macros/latex/contrib/nameauth/nameauth.pdf
+++ b/macros/latex/contrib/nameauth/nameauth.pdf
Binary files differ