xgfmerge (1) - Linux Man Pages

xgfmerge: merges two Xgridfit program files

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

If xmlstarlet is found in the system, xgfmerge uses it to format the output. Otherwise, the output file will be messy but valid.

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/local/share/xgridfit/util/merge.xsl

An XSLT script that performs the merge.

/usr/local/share/xgridfit/util/xinclude.xsl

An XSLT script that strips out unwanted XIncludes.

/usr/local/share/xgridfit/util/sort-glyphs.xsl

An XSLT script that sorts glyph elements in a file.

/usr/local/share/xgridfit/utils/add-blanks.sed

Does some formatting of the output.

AUTHOR

Xgfmerge was written by Peter Baker <psb6m [at] virginia.edu>.

This manual page was written by Peter Baker