OS Manuals

/opt/chainguard/gftools/bin/ufomerge

Google Fonts Tools: build, fix, check and package fonts for the Google Fonts library

From gftools 0.10.8-r0 (os), captured 2026-11-05 by running ufomerge --help (exit 0). permalink

usage: ufomerge [-h] [-g GLYPHS] [-G GLYPHS_FILE] [-u CODEPOINTS] [-U CODEPOINTS_FILE]
                [-x EXCLUDE_GLYPHS] [-X EXCLUDE_GLYPHS_FILE] [--skip-existing |
                --replace-existing] [--subset-layout | --layout-closure | --ignore-layout]
                [--duplicate-lookups {first,both}] [--dotted-circle | --no-dotted-circle]
                [--output OUTPUT] [--fea-include-dir FEA_INCLUDE_DIR] [--verbose]
                ufo1 ufo2

Merge together two source fonts in UFO format

positional arguments:
  ufo1                  UFO font file to merge into
  ufo2                  UFO font file to merge

options:
  -h, --help            show this help message and exit
  --dotted-circle, --no-dotted-circle
                        Merge anchors if both fonts contain a dotted circle glyph
  --output, -o OUTPUT   Output UFO font file
  --fea-include-dir FEA_INCLUDE_DIR
                        Include directory for feature files
  --verbose, -v         Increase logging verbosity

glyph selection:
  -g, --glyphs GLYPHS   Glyphs to add from UFO 2
  -G, --glyphs-file GLYPHS_FILE
                        File containing glyphs to add from UFO 2
  -u, --codepoints CODEPOINTS
                        Unicode codepoints to add from UFO 2
  -U, --codepoints-file CODEPOINTS_FILE
                        File containing Unicode codepoints to add from UFO 2
  -x, --exclude-glyphs EXCLUDE_GLYPHS
                        Glyphs to exclude from UFO 2
  -X, --exclude-glyphs-file EXCLUDE_GLYPHS_FILE
                        File containing glyphs to exclude from UFO 2

Existing glyph handling:
  --skip-existing       Skip glyphs already present in UFO 1
  --replace-existing    Replace glyphs already present in UFO 1

Layout closure handling:
  --subset-layout       Drop layout rules concerning glyphs not selected
  --layout-closure      Add glyphs from UFO 2 contained in layout rules, even if not in glyph set
  --ignore-layout       Don't try to parse the layout rules
  --duplicate-lookups {first,both}
                        How to handle duplicate lookups in the merged font
Options (17)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--dotted-circle, --no-dotted-circleMerge anchors if both fonts contain a dotted circle glyphhelp
--output, -o OUTPUTOutput UFO font filehelp
--fea-include-dir FEA_INCLUDE_DIRInclude directory for feature fileshelp
--verbose, -vIncrease logging verbosityhelp
-g, --glyphs GLYPHSGlyphs to add from UFO 2help
-G, --glyphs-file GLYPHS_FILEFile containing glyphs to add from UFO 2help
-u, --codepoints CODEPOINTSUnicode codepoints to add from UFO 2help
-U, --codepoints-file CODEPOINTS_FILEFile containing Unicode codepoints to add from UFO 2help
-x, --exclude-glyphs EXCLUDE_GLYPHSGlyphs to exclude from UFO 2help
-X, --exclude-glyphs-file EXCLUDE_GLYPHS_FILEFile containing glyphs to exclude from UFO 2help
--skip-existingSkip glyphs already present in UFO 1help
--replace-existingReplace glyphs already present in UFO 1help
--subset-layoutDrop layout rules concerning glyphs not selectedhelp
--layout-closureAdd glyphs from UFO 2 contained in layout rules, even if not in glyph sethelp
--ignore-layoutDon't try to parse the layout ruleshelp
--duplicate-lookups firstHow to handle duplicate lookups in the merged fonthelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.