1XGFCONFIG(1) General Commands Manual XGFCONFIG(1)
2
3
4
6 xgfconfig - configuration program for Xgridfit
7
9 xgfconfig options [list]
10
12 Xgfconfig selects XSLT processors and RELAX NG validators for Xgridfit
13 to use; it can also be used to specify a new Xgridfit base directory.
14
15 Xgridfit maintains lists of validators and processors; on starting, it
16 consults these lists and runs the first validator and processor it can
17 find. Xgfconfig reorders these lists so that your preferred programs
18 are looked for first. Xgfconfig may be invoked in one of these forms:
19
20 $ xgfconfig --processors processor-list
21
22 $ xgfconfig --validators validator-list
23
24 $ xgfconfig --xgridfit-dir /xgridfit/directory
25
26 $ xgfconfig --show
27
28 The first of these selects processors (one or more of libxslt, lxml,
29 xsltproc, saxon-6, saxon-9, xalan-j, xalan-c, 4xslt); the second
30 selects validators (one or more of libxml2, lxml, jing, msv, rnv); the
31 third specifies a complete path to the Xgridfit base directory (use it
32 if you have installed Xgridfit in your own account rather than system
33 wide); the fourth displays the current configuration.
34
35 Several of the processors and validators that Xgridfit knows about are
36 Java programs; for these, Xgridfit needs the name and location of a
37 .jar file (by default it assumes certain standard file names, found in
38 /usr/share/java). Specify this with a hash-mark followed by a complete
39 path-name for the file. Here are sample command lines:
40
41 $ xgfconfig -p saxon-9#/usr/local/share/java/saxon9he.jar lxml
42
43 $ xgfconfig --config=config.xml -V rnv msv#/home/me/java/msv.jar
44
45 The second of these commands stores the configuration in the file con‐
46 fig.xml in the current directory. (When it starts, Xgridfit looks first
47 for a file config.xml in the current directory; failing that, it looks
48 for ~/.xgridfit/config.xml (Linux/Mac) or some-path (Windows); finally
49 it looks in the Xgridfit base directory before giving up and using the
50 default configuration.)
51
52 An Xgridfit configuration file is a simple XML file, easily editable by
53 users. The entries in it should be all but self-explanatory.
54
56 --config
57 The configuration file to read or write. If this is not
58 specified, Xgfconfig will search in the standard places (see
59 above) for an existing configuration file for which the user has
60 write privileges. Failing that, it will create a configuration
61 file in the directory ~/.xgridfit (Linux/Mac) or some-dir
62 (Windows). If the user is root or has administrative privileges,
63 Xgfconfig will create the file in the Xgridfit base directory.
64
65 -h, --help
66 Display a help message and exit.
67
68 -p, --processors
69 The list following the options is a list of processors.
70
71 -s, --show
72 Display the current configuration and exit.
73
74 -V, --validators
75 The list following the options is a list of validators.
76
77 -x, --xgridfit-dir
78 Following the options is the full pathname of the Xgridfit base
79 directory.
80
82 fontforge(1), xgridfit(1), ttx2xgf(1), xgfupdate(1).
83
85 Xgfconfig was written by Peter Baker <psb6m@virginia.edu>.
86
87 This manual page was written by Peter Baker
88
89
90
91 2010-01-16 XGFCONFIG(1)