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