---
name: "xgfmerge"
section: "1"
platform: "linux"
package: "xgridfit"
version: "2.3-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/xgfmerge"
---

# xgfmerge(1)

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

**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)](/xgridfit/1.md), [**ttx**(1)](/ttx/1.md), [**ttx2xgf**(1)](/ttx2xgf/1.md).

## AUTHOR

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

This manual page was written by Peter Baker