accfonts 0.24 (20jan09)

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

1 files changed, 75 insertions, 73 deletions

diff --git a/Master/texmf-dist/doc/fonts/accfonts/README b/Master/texmf-dist/doc/fonts/accfonts/README
index 7f775f1b858..79431d76537 100644
--- a/Master/texmf-dist/doc/fonts/accfonts/README
+++ b/Master/texmf-dist/doc/fonts/accfonts/README
@@ -133,28 +133,28 @@ on the command line, as follows:
   -n should name the font it is intended to generate. Avoid names
      such as "myfont", as both mkt1font and other programs attempt
      to draw conclusions from the name; better would be something
-     like "Utopia_French-BoldItalic". The generated font files will
-     also use this for their basename.
+     like "Utopia_French-BoldItalic". The generated font files
+     will also use this for their basename.
 
   -d should refer to a font definition file. This file (which could
-     usefully be named, e.g., "French.def") should consist of lines
-     of character definitions, in the form
+     usefully be named, e.g., "French.def") should consist of
+     lines of character definitions, in the form
                "number"   "character"
      or
                "number"   "character"   "accent"
      Here "number" represents the character's position in the new
      encoding and may be expressed in decimal, octal or hex;
-     "character" names the character (e.g. "comma", "eight", "A")
-     or consists of the word ".notdef" (indicating that the
-     specified number's "slot" in the new encoding is to be empty);
-     and "accent" optionally names an accent to be placed on the
-     character. In addition to the standard accents available in
-     PostScript fonts, "underbar" and "underdot" are also available,
-     as are "under" versions of all the normal superscript accents
-     ("underdieresis", "underring", etc.). The Indian accent
-     "candrabindu" may also be specified: it is formed by
-     overprinting a breve with a dotaccent. Finally, "overdot" may
-     be used as a synonym for "dotaccent".
+     "character" names the character (e.g. "comma", "eight",
+     "A") or consists of the word ".notdef" (indicating that
+     the specified number's "slot" in the new encoding is to be
+     empty); and "accent" optionally names an accent to be placed
+     on the character. In addition to the standard accents available
+     in PostScript fonts, "underbar" and "underdot" are also
+     available, as are "under" versions of all the normal
+     superscript accents ("underdieresis", "underring", etc.).
+     The Indian accent "candrabindu" may also be specified: it
+     is formed by overprinting a breve with a dotaccent. Finally,
+     "overdot" may be used as a synonym for "dotaccent".
 
      If the character named in the "accent" position is not in fact
      a valid accent character, the program interprets the definition
@@ -210,22 +210,19 @@ Vpl2vpl
 Syntax: vpl2vpl -d definition-file [-s shrink-factor]
            [-c candrabindu-adjustment] [-b] vpl-file
 
-Vpl2vpl creates new TeX virtual fonts based on existing virtual
-fonts ("input fonts"). A successful run will read a vpl (Virtual
-Property List) file and a definition file, and will generate a new
-vpl file on standard output. The input font is assumed to adhere to
-the standard TeX encoding for text fonts unless it was created with
-the program afm2tfm, in which case it is assumed to conform to the
-encoding specified in the file dvips.enc. In either case, the name
-of the input font is assumed to be the name of the input file
-without its .vpl extension: it must conform to normal TeX
-conventions for naming fonts, as vpl2vpl attempts to draw
-conclusions from it about the kind of font it is dealing with.
-
-In the case of a non-virtual font (such as the Computer Modern
-fonts), use a pl (Property List) file, created with the standard
-utility tftopl, as the input file in place of a vpl file; vpl2vpl
-will make the necessary changes on the fly.
+Vpl2vpl creates new TeX virtual fonts based on existing fonts or
+virtual fonts ("input fonts"). A successful run will read a pl
+(Property List) or vpl (Virtual Property List) file and a definition
+file, and will generate a new vpl (Virtual Property List) file on
+standard output. The input font is assumed to adhere to the standard
+TeX encoding for text fonts unless it was created with either of the
+programs afm2pl or afm2tfm, in which case it is assumed to conform to
+(respectively) the Adobe Standard Encoding or the encoding specified
+in the file dvips.enc. In either case, the name of the input font is
+assumed to be the name of the input file without its .vpl or .pl
+extension: it must conform to normal TeX conventions for naming fonts,
+as vpl2vpl attempts to draw conclusions from it about the kind of font
+it is dealing with.
 
 A typical complete sequence of commands to create a new virtual
 font might therefore be
@@ -253,9 +250,9 @@ certain modifications are made to input fonts following the
 dvips.enc encoding to bring them into greater conformity with the
 TeX norm. In particular, the characters dotaccent and hungarumlaut
 are placed in the positions assigned by TeX ("5F, "7D), not those
-enforced by dvips.enc ("C7, "CD). The f-ligatures, double quotes and
-dashes are also moved from the upper half of the character set to
-their normal TeX positions. As a result, the following characters
+enforced by dvips.enc ("C7, "CD). The f-ligatures, double quotes
+and dashes are also moved from the upper half of the character set
+to their normal TeX positions. As a result, the following characters
 are not found in the lower half of the character set: quotesingle,
 quotedbl, backslash, underscore, braceleft, bar, braceright. These
 characters can, however, be assigned positions in the output font if
@@ -265,25 +262,24 @@ their dvips.enc positions if this were desired.)
 Options:
 
   -d should refer to a font definition file. This file (which could
-     usefully be named, e.g., "French.def") should consist of lines
-     of character definitions, in the form
+     usefully be named, e.g., "French.def") should consist of
+     lines of character definitions, in the form
                "number"   "character"
      or
                "number"   "character"   "accent"
-
      Here "number" represents the character's position in the new
      encoding and may be expressed in decimal, octal or hex;
-     "character" names the character (e.g. "comma", "eight", "A") or
-     consists of the word ".notdef" (indicating that the specified
-     number's "slot" in the new encoding is to be empty); and
-     "accent" optionally names an accent to be placed on the
-     character. In addition to the standard accents available in
-     PostScript fonts, "underbar" and "underdot" are also available,
-     as are "under" versions of all the normal superscript accents
-     ("underdieresis", "underring", etc.). The Indian accent
-     "candrabindu" may also be specified: it is formed by
-     overprinting a breve with a dotaccent. Finally, "overdot" may
-     be used as a synonym for "dotaccent".
+     "character" names the character (e.g. "comma", "eight",
+     "A") or consists of the word ".notdef" (indicating that
+     the specified number's "slot" in the new encoding is to be
+     empty); and "accent" optionally names an accent to be placed
+     on the character. In addition to the standard accents available
+     in PostScript fonts, "underbar" and "underdot" are also
+     available, as are "under" versions of all the normal
+     superscript accents ("underdieresis", "underring", etc.).
+     The Indian accent "candrabindu" may also be specified: it
+     is formed by overprinting a breve with a dotaccent. Finally,
+     "overdot" may be used as a synonym for "dotaccent".
 
      If the character named in the "accent" position is not in fact
      a valid accent character, the program interprets the definition
@@ -335,22 +331,20 @@ Syntax: vpl2ovp -d definition-file [-s shrink-factor]
            [-c candrabindu-adjustment] [-b] vpl-file
 
 Vpl2ovp creates new Omega virtual fonts based on existing TeX
-virtual fonts ("input fonts"). A successful run will read a vpl
-(Virtual Property List) file and a definition file, and will generate
-a new ovp file on standard output. The input font is assumed to adhere
-to the standard TeX encoding for text fonts unless it was created with
-the program afm2tfm, in which case it is assumed to conform to the
-encoding specified in the file dvips.enc. In either case, the name
-of the input font is assumed to be the name of the input file
-without its .vpl extension: it must conform to normal TeX
-conventions for naming fonts, as vpl2ovp attempts to draw
+fonts or virtual fonts ("input fonts"). A successful run will
+read a pl (Property List) or vpl (Virtual Property List) file
+and a definition file, and will generate a new ovp (Omega
+Virtual Property List) file on standard output. The input font
+is assumed to adhere to the standard TeX encoding for text
+fonts unless it was created with either of the programs afm2pl
+or afm2tfm, in which case it is assumed to conform to
+(respectively) the Adobe Standard Encoding or the encoding
+specified in the file dvips.enc. In either case, the name of
+the input font is assumed to be the name of the input file
+without its .vpl or .pl extension: it must conform to normal
+TeX conventions for naming fonts, as vpl2ovp attempts to draw
 conclusions from it about the kind of font it is dealing with.
 
-In the case of a non-virtual font (such as the Computer Modern
-fonts), use a pl (Property List) file, created with the standard
-utility tftopl, as the input file in place of a vpl file; vpl2ovp
-will make the necessary changes on the fly.
-
 A typical complete sequence of commands to create a new virtual
 font might therefore be
      tftopl cmr10.tfm cmr10.pl
@@ -371,16 +365,16 @@ Another approach for a PostScript font is to use afm2tfm:
 values for the heights of some characters, and this can lead to
 bad accent placing.
 
-In order to keep the whole of the character range "F0-"FF free
-for the requirements of the encoding specified in the definition
-file, certain modifications are made to input fonts following the
-dvips.enc encoding to bring them into greater conformity with the
-TeX norm. In particular, the characters dotaccent and hungarumlaut
-are placed in the positions assigned by TeX ("5F, "7D), not those
-enforced by dvips.enc ("C7, "CD). The f-ligatures, double quotes
-and dashes are also moved from the upper half of the character set
-to their normal TeX positions. As a result, the following characters
-are not found in the lower half of the character set: quotesingle,
+In order to keep the whole of the character range "F0-"FF free for
+the requirements of the encoding specified in the definition file,
+certain modifications are made to input fonts following the dvips.enc
+encoding to bring them into greater conformity with the TeX norm. In
+particular, the characters dotaccent and hungarumlaut are placed in
+the positions assigned by TeX ("5F, "7D), not those enforced by
+dvips.enc ("C7, "CD). The f-ligatures, double quotes and dashes are
+also moved from the upper half of the original 8-bit character set to
+their normal TeX positions. As a result, the following characters are
+not found in the lower half of the character set: quotesingle,
 quotedbl, backslash, underscore, braceleft, bar, braceright. These
 characters can, however, be assigned positions in the output font if
 they are needed. (Indeed, they could all be explicitly restored to
@@ -389,7 +383,7 @@ their dvips.enc positions if this were desired.)
 Options:
 
   -d should refer to a font definition file. This file (which could
-     usefully be named, e.g., "French.def") should consist of
+     usefully be named, e.g., "Unicode1.def") should consist of
      lines of character definitions, in the form
                "number"   "character"
      or
@@ -408,6 +402,14 @@ Options:
      is formed by overprinting a breve with a dotaccent. Finally,
      "overdot" may be used as a synonym for "dotaccent".
 
+     Note that all accents used in defining accented characters must
+     themselves be defined in the .def file. Those which exist in the
+     source font should simply be referenced by name in their
+     appropriate Unicode position (e.g. "0x0304 macron"); those
+     which do not should be defined as the character "space"
+     followed by the name of the accent (e.g. "0x0310 space
+     candrabindu").
+
      If the character named in the "accent" position is not in fact
      a valid accent character, the program interprets the definition
      as a request for a digraph formed from the "character" and the