NAME
xgfconfig - configuration program for Xgridfit
SYNOPSIS
xgfconfig options [list]
DESCRIPTION
Xgfconfig selects XSLT processors and RELAX NG validators for Xgridfit
to use; it can also be used to specify a new Xgridfit base directory.
Xgridfit maintains lists of validators and processors; on starting, it
consults these lists and runs the first validator and processor it can
find. Xgfconfig reorders these lists so that your preferred programs
are looked for first. Xgfconfig may be invoked in one of these forms:
$ xgfconfig --processors processor-list
$ xgfconfig --validators validator-list
$ xgfconfig --xgridfit-dir /xgridfit/directory
$ xgfconfig --show
The first of these selects processors (one or more of libxslt, lxml,
xsltproc, saxon-6, saxon-9, xalan-j, xalan-c, 4xslt); the second
selects validators (one or more of libxml2, lxml, jing, msv, rnv); the
third specifies a complete path to the Xgridfit base directory (use it
if you have installed Xgridfit in your own account rather than system
wide); the fourth displays the current configuration.
Several of the processors and validators that Xgridfit knows about are
Java programs; for these, Xgridfit needs the name and location of a
.jar file (by default it assumes certain standard file names, found in
/usr/share/java). Specify this with a hash-mark followed by a complete
path-name for the file. Here are sample command lines:
$ xgfconfig -p saxon-9#/usr/local/share/java/saxon9he.jar lxml
$ xgfconfig --config=config.xml -V rnv msv#/home/me/java/msv.jar
The second of these commands stores the configuration in the file
config.xml in the current directory. (When it starts, Xgridfit looks
first for a file config.xml in the current directory; failing that, it
looks for ~/.xgridfit/config.xml (Linux/Mac) or some-path (Windows);
finally it looks in the Xgridfit base directory before giving up and
using the default configuration.)
An Xgridfit configuration file is a simple XML file, easily editable by
users. The entries in it should be all but self-explanatory.
OPTIONS
--config
The configuration file to read or write. If this is not
specified, Xgfconfig will search in the standard places (see
above) for an existing configuration file for which the user has
write privileges. Failing that, it will create a configuration
file in the directory ~/.xgridfit (Linux/Mac) or some-dir
(Windows). If the user is root or has administrative privileges,
Xgfconfig will create the file in the Xgridfit base directory.
-h, --help
Display a help message and exit.
-p, --processors
The list following the options is a list of processors.
-s, --show
Display the current configuration and exit.
-V, --validators
The list following the options is a list of validators.
-x, --xgridfit-dir
Following the options is the full pathname of the Xgridfit base
directory.
SEE ALSO
fontforge(1), xgridfit(1), ttx2xgf(1), xgfupdate(1).
AUTHOR
Xgfconfig was written by Peter Baker <psb6m@virginia.edu>.
This manual page was written by Peter Baker
2010-01-16