nkarta 0.2 (16dec09)

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

5 files changed, 80 insertions, 44 deletions

diff --git a/Master/texmf-dist/doc/fonts/nkarta/README b/Master/texmf-dist/doc/fonts/nkarta/README
index 6e91f4bb3d8..e46f2d5ed12 100644
--- a/Master/texmf-dist/doc/fonts/nkarta/README
+++ b/Master/texmf-dist/doc/fonts/nkarta/README
@@ -5,69 +5,102 @@ I have been unable to find the author or maintainer or copyright holder
 of the Metafont karta, containing map symbols. Problems have arisen with
 that font, mainly the usual ones: "Strange path" errors and capacity
 exceeded. I have change the coding a bit to try to avoid these. Also,
-there were two paths defined with incorrect turning number, causing
-elements of two figures to be omitted. This was also corrected. Aside
-from that, no actual paths were changed.  To avoid confusion with the
-original files, I have renamed the result nkarta, and place it in the
-public domain.
+there were two paths defined with incorrect turning number, and
+incorrect order of operations (a too-late unfill operation caused
+previously drawn elements of two figures to be erased). This was also
+corrected. Aside from that, no actual paths were changed.
 
+Licence
+-------
+To avoid confusion with the original files, I have renamed the result
+nkarta. Barring any legal claim by the creator of karta.mf, I hereby
+place nkarta in the public domain.
+
+Version
+-------
+This is version 0.2. The previous version failed to include a version
+number. It will be called version 0.1 when I need to refer to it.
+
+Use
+---
 The character shapes are all in nkchars.mf, which is input by a driver
 file nkarta.mf. The font produced has design size 15pt. A file
 nkart15.mf is provided as an example showing how that design size can be
 changed. In order to get a 20pt font, just copy nkarta15.mf to
 nkarta20.mf and then edit it, changing 15 to 20 everywhere.
 
-Finally, to allow larger scaling without risking exceeding Metafont's
-capacity, I have ported the figures to MetaPost in nkarta.mp. These
-figures have the same numbers as the corresponding characters in
-nkarta.mf. That is, after "mpost nkarta.mp", the file nkarta.NN
-contains the same picture as charater NN in the nkarta font. Without
-scaling, they will be the same size that nkarta.mf produces.
+To allow larger scaling without risking exceeding Metafont's capacity, I
+have ported the figures to MetaPost in nkarta.mp. These figures have the
+same numbers as the corresponding characters in nkarta.mf. That is,
+after "mpost nkarta.mp", the file nkarta.NNN contains the same picture
+as charater NNN in the nkarta font. Without scaling, they will be the
+same size that nkarta.mf produces.
 
 One can also run mpost on nkarta15.mf (or nkarta20.mf if prepared as
-above). In that case nkarta15.NN (or nkarta20.NN) has the same figure as
-character NN of the font nkarta15 (or nkarta20).
+above). In that case nkarta15.NNN (or nkarta20.NNN) has the same figure
+as character NNN of the font nkarta15 (or nkarta20).
 
-Files figtest.ps and fonttest.ps provide a table of the available
-figures/characters. They were obtained by running tex on the
-corresponding .tex files and then dvips (with option -Z in the case of
-fonttable.dvi).
+Files figtest.pdf and fonttest.pdf provide a table of the available
+figures/characters.
 
-To install nkarta:
+Installing nkarta
 -----------------
-1. Copy the .mf files somewhere Metafont will find them. In a TDS compliant
-   system, that would be a subdirectory path similar to
-       texmf-local/fonts/source/public/nkarta
+ 0. Run tex or latex on nkarta.ins to generate the *.mf and *.mp source
+    files.
+
+ 1. Copy the .mf files somewhere Metafont will find them. In a TDS
+    compliant system, that would be a subdirectory path similar to
+       texmf/fonts/source/public/nkarta
 
-2. Copy the .tfm file somewhere TeX searches for TFM files, for example
-       texmf-local/fonts/tfm/public/nkarta
+ 2. Copy the .tfm file somewhere TeX searches for TFM files, for example
+       texmf/fonts/tfm/public/nkarta
 
-3. Copy the .mp file and nkchars.mf where MetaPost will find them, for
-   example:
-       texmf-local/metapost/nkarta
-   (If your MP already looks in the MF search path, this second copy of
-   nkchars.mf is not necessary.)
+ 3. Copy the .mp files where MetaPost will find them, for example:
+       texmf/metapost/nkarta
 
-4. Copy readme, *.tex and *.ps where documentation is kept, for example:
-       texmf-local/doc/fonts/nkarta
+ 4. Copy README, *.tex and *.pdf where documentation is kept, for example:
+       texmf/doc/fonts/nkarta
 
-5. Refresh the filename database, if your system requires it.
+ 5. Copy nkarta.dtx and nkarta.ins where source files are kept, for example:
+       texmf/source/fonts/nkarta
+
+ 6. Refresh the filename database (mktexlsr or MiKTeX Options).
 
 A list of the files and their uses.
 
-  README           This file.
-  nkarta.mf        Preliminary definitions for MF
-  nkarta.mp        Preliminary definitions for MP
-  nkchars.mf       Actual figures, input by nkarta.mf and nkarta.mp
-  nkarta15.mf      The font at 15pt.
-  nkarta15.tfm     Prebuilt .tfm file.
-  fonttable.tex    A table of the characters (requires testfont.tex
-                   and nkarta15.tfm).
-  fonttable.ps     Prebuilt PS file from running tex and dvips on above.
-  figtable.tex     A table of the figures (requires testfont.tex,
-                   epsf.tex, and nkarta15.tfm).
-  figtable.ps      Prebuilt PS file from running tex and dvips on above.
+  README            This file
+  nkarta.ins        The script for unpacking nkarta.dtx
+  nkarta.dtx        The source for the next five files:
+    nkarta.mf       Preliminary definitions for MF
+    nkarta.mp       Preliminary definitions for MP
+    nkchars.mf      Actual characters, input by nkarta.mf
+    nkchars.mp      Actual figures, input by nkarta.mp  (a)
+    nkarta15.mf     MF source for the font at 15pt
+  nkarta15.tfm      Prebuilt TFM file
+  fonttable.tex     Source for a table of the characters
+  figtable.tex      Source for a table of the figures
+  fonttable.pdf     Prebuilt PDF file  (b)
+  figtable.pdf      Prebuilt PDF file  (c)
+
+  Notes:
+  (a) nkchars.mf and nkchars.mp are identical (apart from comments). You
+      can discard the second one if MetaPost is configured to find the
+      first one.
+  (b) fonttable.pdf was built by running
+        tex fonttable.tex
+        dvips fonttable.dvi
+        ps2pdf fonttable.ps
+      This requires testfont.tex and nkarta15.tfm
+  (c) figtable.pdf was built by running
+        mpost nkarta.mp
+        tex figtable.tex
+        dvips figtable.dvi
+        ps2pdf figtable.ps
+      This requires testfont.tex, epsf.tex and nkarta15.tfm.
 
+The only change from version 0.1 to 0.2 of nkarta to this one is a
+repackaging, and streamlining of the code. Also, more than 100K of
+garbage following "end" in nkarta.mp was removed.
 
 --
 Daniel H. Luecking      email: luecking at uark dot edu
diff --git a/Master/texmf-dist/doc/fonts/nkarta/figtable.pdf b/Master/texmf-dist/doc/fonts/nkarta/figtable.pdf
index 2131e026cb7..c1c011e79f9 100644
--- a/Master/texmf-dist/doc/fonts/nkarta/figtable.pdf
+++ b/Master/texmf-dist/doc/fonts/nkarta/figtable.pdf
diff --git a/Master/texmf-dist/doc/fonts/nkarta/figtable.tex b/Master/texmf-dist/doc/fonts/nkarta/figtable.tex
index 360cd37ddda..0e8398a778d 100644
--- a/Master/texmf-dist/doc/fonts/nkarta/figtable.tex
+++ b/Master/texmf-dist/doc/fonts/nkarta/figtable.tex
@@ -4,12 +4,13 @@
   \ifeof\q \else \global\p=0 \fi \closein\q}%
 \let\noinit=!
 \def\fontname{nkarta15}%
+% If mpost is run on nkarta15.mf, change the following accordingly.
 \def\figname{nkarta}%
 \input testfont
 \def\:{\p=1\testexists\n
     \setbox0=\hbox{%
       \ifnum\p=0
-        \epsfbox{\figname.\the\n}%
+        \epsfbox{\figname.\number\n}%
       \fi}%
   \ifdim\ht0>7.5pt\reposition
   \else\ifdim\dp0>2.5pt\reposition\fi\fi
@@ -25,6 +26,7 @@
     \repeat
   }%
 }%
+\footline{\hfil\tt\jobname.tex\hfil}
 \centerlargechars
 \startfont
 \table
diff --git a/Master/texmf-dist/doc/fonts/nkarta/fonttable.pdf b/Master/texmf-dist/doc/fonts/nkarta/fonttable.pdf
index abe1978647f..e61750c1356 100644
--- a/Master/texmf-dist/doc/fonts/nkarta/fonttable.pdf
+++ b/Master/texmf-dist/doc/fonts/nkarta/fonttable.pdf
diff --git a/Master/texmf-dist/doc/fonts/nkarta/fonttable.tex b/Master/texmf-dist/doc/fonts/nkarta/fonttable.tex
index 988c549ab37..b766b5b3f84 100644
--- a/Master/texmf-dist/doc/fonts/nkarta/fonttable.tex
+++ b/Master/texmf-dist/doc/fonts/nkarta/fonttable.tex
@@ -1,6 +1,7 @@
 \let\noinit=!%
 \def\fontname{nkarta15}%
 \input testfont
+\footline{\hfil\tt\jobname.tex\hfil}
 \centerlargechars
 \startfont
 \table