summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-11-12 22:17:08 +0000
committerKarl Berry <karl@freefriends.org>2015-11-12 22:17:08 +0000
commitd7234c8b1a0b9dd638531f41e22cb99a6952c474 (patch)
tree2a940d903fef9b0d12ba5c2c08956863b552e1fe /Master/texmf-dist/doc
parent0af11921db2db5ec5f91fc203ee43ebdba0a18c4 (diff)
nameauth (12nov15)
git-svn-id: svn://tug.org/texlive/trunk@38829 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/Makefile92
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/README93
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/README.txt90
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/nameauth.hd0
-rw-r--r--Master/texmf-dist/doc/latex/nameauth/nameauth.pdfbin706194 -> 687563 bytes
5 files changed, 192 insertions, 83 deletions
diff --git a/Master/texmf-dist/doc/latex/nameauth/Makefile b/Master/texmf-dist/doc/latex/nameauth/Makefile
index f5c6c35da7e..e3989ed9cba 100644
--- a/Master/texmf-dist/doc/latex/nameauth/Makefile
+++ b/Master/texmf-dist/doc/latex/nameauth/Makefile
@@ -1,52 +1,40 @@
-engine ?= pdflatex # Override on the command line
- # with engine=latex
- # or with engine=xelatex
- # or with engine=lualatex.
- # If with lualatex, then use the fullpdf target.
-
-# The default builds the distribution uploaded to CTAN.
-dist: pdf clean
-
-# Making this target includes the code listing
-fullpdf : sty
- $(engine) nameauth.dtx
- makeindex -s gglo.ist -o nameauth.gls nameauth.glo
- makeindex -s gind.ist -o nameauth.ind nameauth.idx
- $(engine) nameauth.dtx
- $(engine) nameauth.dtx
-
-# This target omits the code listing.
-pdf : sty
- $(engine) -draftmode "\AtBeginDocument{\OnlyDescription} \input nameauth.dtx"
- makeindex -s gglo.ist -o nameauth.gls nameauth.glo
- makeindex -s gind.ist -o nameauth.ind nameauth.idx
- $(engine) "\AtBeginDocument{\OnlyDescription} \input nameauth.dtx"
- $(engine) "\AtBeginDocument{\OnlyDescription} \input nameauth.dtx"
-
-# Build the package.
-sty : nameauth.dtx nameauth.ins
- $(engine) nameauth.ins
-
-# Instead of using the shell to see if files exist, take advantage of rm.
-clean :
- rm -f nameauth.aux
- rm -f nameauth.glo
- rm -f nameauth.gls
- rm -f nameauth.idx
- rm -f nameauth.ilg
- rm -f nameauth.ind
- rm -f nameauth.log
- rm -f nameauth.out
- rm -f nameauth.toc
- rm -f nameauth.hd
- rm -f nameauth.top
- rm -f texput.*
-
-# Remove all but the barest source files.
-clobber : clean
- rm -f nameauth.dvi
- rm -f nameauth.pdf
- rm -f nameauth.sty
- touch nameauth.*
-
-
+NAME = nameauth
+ENGINE ?= pdflatex
+# On the command line:
+# make ENGINE=latex
+# make ENGINE=xelatex
+# make ENGINE=lualatex
+SHELL = bash
+PWD = $(shell pwd)
+VERS = $(shell ltxfileinfo -v $(NAME).dtx|sed -e 's/^v//')
+LOCAL = $(shell kpsewhich --var-value TEXMFLOCAL)
+UTREE = $(shell kpsewhich --var-value TEXMFHOME)
+all: $(NAME).pdf
+ test -e README.txt && mv README.txt README || exit 0
+$(NAME).pdf: $(NAME).dtx
+ $(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
+ if [ -f $(NAME).idx ]; then makeindex -q -s gind.ist -o $(NAME).ind $(NAME).idx; fi
+ $(ENGINE) --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
+ $(ENGINE) --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
+clean:
+ rm -f $(NAME).{aux,fls,glo,gls,hd,idx,ilg,ind,ins,log,out,toc} README.txt
+distclean: clean
+ rm -f $(NAME).{pdf,sty} README
+inst: all
+ mkdir -p $(UTREE)/{tex,source,doc}/latex/$(NAME)
+ cp $(NAME).dtx $(UTREE)/source/latex/$(NAME)
+ cp Makefile $(UTREE)/source/latex/$(NAME)
+ cp $(NAME).sty $(UTREE)/tex/latex/$(NAME)
+ cp $(NAME).pdf $(UTREE)/doc/latex/$(NAME)
+install: all
+ sudo mkdir -p $(LOCAL)/{tex,source,doc}/latex/$(NAME)
+ sudo cp $(NAME).dtx $(LOCAL)/source/latex/$(NAME)
+ sudo cp Makefile $(LOCAL)/source/latex/$(NAME)
+ sudo cp $(NAME).sty $(LOCAL)/tex/latex/$(NAME)
+ sudo cp $(NAME).pdf $(LOCAL)/doc/latex/$(NAME)
+zip: all
+ ln -sf . $(NAME)
+ zip -Drq $(PWD)/$(NAME)-$(VERS).zip $(NAME)/{README,Makefile,$(NAME).{pdf,dtx}}
+ rm $(NAME)
diff --git a/Master/texmf-dist/doc/latex/nameauth/README b/Master/texmf-dist/doc/latex/nameauth/README
index 137bcacd4ed..1063131bddd 100644
--- a/Master/texmf-dist/doc/latex/nameauth/README
+++ b/Master/texmf-dist/doc/latex/nameauth/README
@@ -1,59 +1,90 @@
-The nameauth package
-Charles P. Schaum
-charles dot schaum at comcast dot net
-v1.9 from 2015/07/09
+|
+--------:| ----------------------------------------------------------------
+nameauth:| Name authority mechanism for consistency in text and index
+ Author:| Charles P. Schaum
+ E-mail:| charles dot schaum at comcast dot net
+ License:| Released under the LaTeX Project Public License v1.3c or later
+ See:| http://www.latex-project.org/lppl.txt
-Abstract
+Short description:
The nameauth package automates the formatting and indexing of names.
This aids the use of a name authority and the process of textual reordering
and revision without needing to retype name references.
-Files Distribution
+Files Distribution
-README This file (normally in TEXMFDIST/doc/latex/nameauth)
-nameauth.pdf Documentation (normally in TEXMFDIST/doc/latex/nameauth)
+README This file
+nameauth.pdf Documentation
-Makefile Automates building with GNU make 3.81
-nameauth.ins Installer
-nameauth.dtx Documented LaTeX file containing both code and documentation
+Makefile Automates building with GNU make 3.81
+nameauth.dtx Documented LaTeX file containing both code and documentation
Installation
-Unpack nameauth.zip.
+Unpack nameauth.zip in an appropriate directory.
-Generate the file nameauth.sty, e.g.:
- $ pdflatex nameauth.ins
+Note that the instructions below assume that you are using a *nix-
+compatible computer. If that is otherwise, you will need to modify
+these instructions to your needs.
-Usually this will go in TEXMFDIST/tex/latex/nameauth.
+If you have a make utility compatible with GNU make you can type
-Generate the documentation (optimal with pdflatex):
- $ pdflatex nameauth.dtx -draftmode "\AtBeginDocument{\OnlyDescription} \input nameauth.dtx"
- $ makeindex -s gglo.ist -o nameauth.gls nameauth.glo
- $ makeindex -s gind.ist -o nameauth.ind nameauth.idx
- $ pdflatex nameauth.dtx "\AtBeginDocument{\OnlyDescription} \input nameauth.dtx"
- $ pdflatex nameauth.dtx "\AtBeginDocument{\OnlyDescription} \input nameauth.dtx"
+make inst
-I used GNU make to automate the process. See the makefile for more options:
- $ make
+to install the package into your $TEXMFHOME tree or
-Create the directories listed above. For TeX Live, TEXMFDIST is often /usr/local/texmf/<year>/texmf-dist on Posix-compliant systems. Manual installation calls rather for /usr/local/texlive/texmf-local or ~/texmf.
+make install
-MacTeX and MikTeX differ. Please refer to your distribution manual.
+to install the package into your $TEXMFLOCAL tree for all users.
-Copy the distribution files to their appropriate destinations.
+Manually, you can generate the package files. First you generate the
+installer driver, README, and style files, with a preliminary PDF:
-Run mktexlsr with the appropriate level of permissions.
+pdflatex -shell-escape -recorder -interaction=batchmode nameauth.dtx
+
+Next you generate the PDF with a table of contents and all cross-references
+validated, so that the index entries will not move:
+
+pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+
+The next commands generate the glossary/index and final pdf file
+
+makeindex -q -s gglo.ist -o nameauth.gls nameauth.glo
+makeindex -q -s gind.ist -o nameauth.ind nameauth.idx
+pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+
+Normally you create the following manual installation directories for user:
+
+$TEXMFHOME/source/latex/nameauth dtx file
+$TEXMFHOME/tex/latex/nameauth sty file
+$TEXMFHOME/doc/latex/nameauth pdf file
+
+and you create the following manual installation directories for local site:
+
+$TEXMFLOCAL/source/latex/nameauth dtx file
+$TEXMFLOCAL/tex/latex/nameauth sty file
+$TEXMFLOCAL/doc/latex/nameauth pdf file
+
+The above environment variables often are /usr/local/texlive/texmf-local and
+~/texmf.
+
+Run mktexlsr with the appropriate level of permissions to complete the install.
Testing notes:
-This packages works and builds with the commands latex, lualatex, pdflatex, and xelatex. It can be used with makeindex and texindy. I have built the package documentation successfully with lualatex, pdflatex, and xelatex, using only makeindex.
+This packages works and builds with latex, lualatex, pdflatex, and xelatex.
+It can be used with makeindex and texindy. The documentation builds with
+lualatex, pdflatex, and xelatex, using makeindex.
-For testing purposes, the make file permits one to change the typesetting engine on the command line. The default is to build the package with pdflatex. See Makefile for more details.
+For testing, the make file permits one to change the typesetting engine
+on the command line. The default is to build the package and documentation
+with pdflatex. See the make file for details.
License
-This material is subject to the LaTeX Project Public License. See http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the details of that license.
+This material is subject to the LaTeX Project Public License:
+http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
Happy TeXing!
-
diff --git a/Master/texmf-dist/doc/latex/nameauth/README.txt b/Master/texmf-dist/doc/latex/nameauth/README.txt
new file mode 100644
index 00000000000..1063131bddd
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nameauth/README.txt
@@ -0,0 +1,90 @@
+|
+--------:| ----------------------------------------------------------------
+nameauth:| Name authority mechanism for consistency in text and index
+ Author:| Charles P. Schaum
+ E-mail:| charles dot schaum at comcast dot net
+ License:| Released under the LaTeX Project Public License v1.3c or later
+ See:| http://www.latex-project.org/lppl.txt
+
+Short description:
+
+The nameauth package automates the formatting and indexing of names.
+This aids the use of a name authority and the process of textual reordering
+and revision without needing to retype name references.
+
+Files Distribution
+
+README This file
+nameauth.pdf Documentation
+
+Makefile Automates building with GNU make 3.81
+nameauth.dtx Documented LaTeX file containing both code and documentation
+
+Installation
+
+Unpack nameauth.zip in an appropriate directory.
+
+Note that the instructions below assume that you are using a *nix-
+compatible computer. If that is otherwise, you will need to modify
+these instructions to your needs.
+
+If you have a make utility compatible with GNU make you can type
+
+make inst
+
+to install the package into your $TEXMFHOME tree or
+
+make install
+
+to install the package into your $TEXMFLOCAL tree for all users.
+
+Manually, you can generate the package files. First you generate the
+installer driver, README, and style files, with a preliminary PDF:
+
+pdflatex -shell-escape -recorder -interaction=batchmode nameauth.dtx
+
+Next you generate the PDF with a table of contents and all cross-references
+validated, so that the index entries will not move:
+
+pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+
+The next commands generate the glossary/index and final pdf file
+
+makeindex -q -s gglo.ist -o nameauth.gls nameauth.glo
+makeindex -q -s gind.ist -o nameauth.ind nameauth.idx
+pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+pdflatex --recorder --interaction=nonstopmode nameauth.dtx
+
+Normally you create the following manual installation directories for user:
+
+$TEXMFHOME/source/latex/nameauth dtx file
+$TEXMFHOME/tex/latex/nameauth sty file
+$TEXMFHOME/doc/latex/nameauth pdf file
+
+and you create the following manual installation directories for local site:
+
+$TEXMFLOCAL/source/latex/nameauth dtx file
+$TEXMFLOCAL/tex/latex/nameauth sty file
+$TEXMFLOCAL/doc/latex/nameauth pdf file
+
+The above environment variables often are /usr/local/texlive/texmf-local and
+~/texmf.
+
+Run mktexlsr with the appropriate level of permissions to complete the install.
+
+Testing notes:
+
+This packages works and builds with latex, lualatex, pdflatex, and xelatex.
+It can be used with makeindex and texindy. The documentation builds with
+lualatex, pdflatex, and xelatex, using makeindex.
+
+For testing, the make file permits one to change the typesetting engine
+on the command line. The default is to build the package and documentation
+with pdflatex. See the make file for details.
+
+License
+
+This material is subject to the LaTeX Project Public License:
+http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
+
+Happy TeXing!
diff --git a/Master/texmf-dist/doc/latex/nameauth/nameauth.hd b/Master/texmf-dist/doc/latex/nameauth/nameauth.hd
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nameauth/nameauth.hd
diff --git a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
index aa2a6de5bd8..c79aba1f6e1 100644
--- a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
+++ b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
Binary files differ