NAME

       xgfmerge - merges two Xgridfit program files

SYNOPSIS

       xgfmerge [options] file-a file-b [...]

DESCRIPTION

       Xgfmerge  merges  two  or more Xgridfit program files, where file-a is a program generated
       automatically from an existing font using TTX and ttx2xgf, and file-b and any other  files
       in  the  list  contain  other  programming  for  the  font.   Xgfmerge  outputs the merged
       programming to stdout.  To capture the output in a file, use this syntax:

            $xgfmerge -o merged-file.xgf file-a.xgf file-b.xgf

       Note: To merge Xgridfit instructions with those already in a font, the best method is  now
       to run Xgridfit in merge-mode (option -m).

OPTIONS

       -c     Look  for  a <default type="compile-globals"/> element in each file after the first
              in the list. If value="no" then ignore all <default>, <control-value>,  <function>,
              <macro> and <pre-program> elements in the file.

       -h     Display a help message.

       -n     Merge  <no-compile>  elements  from all files. <glyph> elements with duplicate "ps-
              name" attributes are ignored.

       -o file
              The file to write the output to. If this option is not used, output is  written  to
              stdout.

       -p     When  a  <pre-program>  element  in  a  file other than file-a is available, use it
              instead of the one from file-a. If this option is not present, xgfmerge merges  the
              programming  in  the  <pre-program>  of  file-a  with  that in the <pre-program> of
              whichever file is being merged at the moment.  The result is unlikely to be good if
              a  single  run  of  xgfmerge  merges  the  contents  of more than two <pre-program>
              elements.

       -s     Sort <glyph> elements in the output file into alphabetical order.

       -v     Verbose output: xgfmerge tells you what it is doing at each step.

       -x     Resolve XIncludes before merging all files in  the  list  except  for  file-a.  Any
              XIncludes  from  file-a.xgf  are stripped out of the files before this operation is
              performed.  If  XInclude  is  used  to  bring  global  elements   (<control-value>,
              <function>, etc.) into these files, it is probably a good idea to use the -c option
              as well.

FILES

       /usr/share/xml/xgridfit/util/merge.xsl
              An XSLT script that performs the merge.

       /usr/share/xml/xgridfit/util/xinclude.xsl
              An XSLT script that strips out unwanted XIncludes.

       /usr/share/xml/xgridfit/util/sort-glyphs.xsl
              An XSLT script that sorts glyph elements in a file.

       /usr/share/xml/xgridfit/utils/add-blanks.sed
              Does some formatting of the output.

SEE ALSO

       xgridfit(1), ttx(1), ttx2xgf(1).

AUTHOR

       Xgfmerge was written by Peter Baker <psb6m@virginia.edu>.

       This manual page was written by Peter Baker

                                            2009-12-18                                XGFMERGE(1)