nameauth (27jul12)

git-svn-id: svn://tug.org/texlive/trunk@27203 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 37 insertions, 22 deletions

diff --git a/Master/texmf-dist/doc/latex/nameauth/Makefile b/Master/texmf-dist/doc/latex/nameauth/Makefile
index 71694f7a7d3..f5c6c35da7e 100644
--- a/Master/texmf-dist/doc/latex/nameauth/Makefile
+++ b/Master/texmf-dist/doc/latex/nameauth/Makefile
@@ -1,15 +1,11 @@
 engine ?= pdflatex	# Override on the command line
 			# with engine=latex
-			# or with engine=lualatex
-			# or with engine=xelatex.
+			# or with engine=xelatex
+			# or with engine=lualatex.
+			# If with lualatex, then use the fullpdf target.
 
-# The pdf target is the normal one. It 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"
+# The default builds the distribution uploaded to CTAN.
+dist:		pdf clean
 
 # Making this target includes the code listing
 fullpdf	:	sty
@@ -19,9 +15,19 @@ fullpdf	:	sty
 		$(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
@@ -34,12 +40,13 @@ clean	:
 		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.*
 
-dist:		pdf clean
 
diff --git a/Master/texmf-dist/doc/latex/nameauth/README b/Master/texmf-dist/doc/latex/nameauth/README
index 2ccdbb59aec..444b3c0f9c7 100644
--- a/Master/texmf-dist/doc/latex/nameauth/README
+++ b/Master/texmf-dist/doc/latex/nameauth/README
@@ -1,15 +1,15 @@
 The nameauth package
 Charles P. Schaum
 charles dot schaum at att dot net
-v1.26 from 2012/04/24
+v1.4 from 2012/07/24
 
 Abstract
 
-Using the nameauth package, an author can encode names according to a
-name authority. Index entries are consistent with input parameters. In-text
-formatting of names is predictable and automated, making it easier to go
-from drafts to a final manuscript. This package mainly supports Western
-names, with basic features for ancient, royal, and Eastern names.
+The nameauth package automates the formatting and indexing of names,
+facilitating the implementation of a name authority. This allows one to
+move blocks of text without retyping names, making it easier to go from
+drafts to a final manuscript. This package mainly supports Western names,
+with basic features for ancient, royal, and Eastern names.
 
 Files		Target distribution
 
@@ -39,24 +39,32 @@ Source distribution notes:
 
 One can use the following commands to generate the target distribution:
 
-Generate the style file with:
+Generate the style file with any form of LaTeX:
 	$ pdflatex nameauth.ins
 
-Generate the documentation with:
+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"
 
-I used GNU make to automate the process:
-	$ make dist
+I used GNU make to automate the process, As of v.1.4, the following apply:
+
+	Create the distribution. Works with latex, pdflatex, and xelatex:
+
+	$ make
+
+	Create the full pdf. Works with all of the above plus lualatex.
+	(Lualatex handles -draftmode in an incompatible manner.)
+
+	$ make fullpdf
 
 Testing notes:
 
-This packages works with the commands latex, lualatex, pdflatex, and xelatex. It has created inxexes successfully with makeindex and texindy.
+This packages works with the commands latex, lualatex, pdflatex, and xelatex. It can be used with makeindex and texindy (but I have not done so for building the package itself).
 
-For testing purposes, I modified the make file so that one can change the typesetting engine on the command line. The way that the make file is designed, the pdf target really depends on just they .sty file being made, so it can generate .dvi files just as easily. The default behavior (shown above) builds with pdflatex. That is the preferred method for creating the package.
+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.
 
 License
 
diff --git a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
index 4797757d820..7d69bda5105 100644
--- a/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf
+++ b/Master/texmf-dist/doc/latex/nameauth/nameauth.pdf