XGFCONFIG(1)

✨ XGFCONFIG(1) — General Commands Manual ✨

bestie it's literally xgfconfig, a manual page from the General Commands Manual section, and it's about to make your Xgridfit life so much easier 💖

---

🎀 NAME 🎀

xgfconfig — the configuration program for Xgridfit, no cap.

---

🌸 SYNOPSIS 🌸

xgfconfig options [list]

---

🦋 DESCRIPTION 🦋

Okay so listen. Xgfconfig picks out XSLT processors and RELAX NG validators for Xgridfit to use, and it can also set a whole new Xgridfit base directory. Multitasking queen behavior, honestly 💅

Xgridfit keeps lists of validators and processors, right? And when it starts up, it consults those lists and runs the first validator and processor it can find. What Xgfconfig does is reorder those lists so your faves get looked for first. Main character energy for your preferred programs, periodt.

You can invoke Xgfconfig in one of these forms:

$ xgfconfig --processors processor-list

$ xgfconfig --validators validator-list

$ xgfconfig --xgridfit-dir /xgridfit/directory

$ xgfconfig --show

So the first one 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 installed Xgridfit in your own account instead of system wide, iykyk 🫶). And the fourth displays the current configuration. Cute, right?

---

Now, plot twist: several of the processors and validators that Xgridfit knows about are Java programs 😭 and for those, Xgridfit needs the name and location of a .jar file. By default it assumes certain standard file names, found in /usr/share/java. You specify it 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. ✨

And 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. The way that it checks three whole places before admitting defeat… relatable 💀

An Xgridfit configuration file is a simple XML file, easily editable by users. The entries in it should be all but self-explanatory. Slay.

---

✨ OPTIONS ✨

• --config — the configuration file to read or write. If this isn't specified, Xgfconfig will search in the standard places (see above 👀) for an existing configuration file that the user has write privileges for. Failing that, it will create a configuration file in the directory ~/.xgridfit (Linux/Mac) or some-dir (Windows). And if the user is root or has administrative privileges, Xgfconfig will create the file in the Xgridfit base directory. Root girlies get the base directory, that's just how it is 👑
• -h, --help — display a help message and exit. Short, sweet, iconic.
• -p, --processors — the list following the options is a list of processors.
• -s, --show — display the current configuration and exit. Vibe check on your setup, fr fr.
• -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) — go read those too bestie, they're all part of the squad 🫶

---

🌈 AUTHOR 🌈

Xgfconfig was written by Peter Baker <psb6m@virginia.edu>.

This manual page was written by Peter Baker — yeah, same person, he did both, we love a multi-talented icon 💅

---

okay that's the whole thing!! this page is from 2010-01-16 and it lives in the XGFCONFIG(1) manual section — bye bestie, go configure something gorgeous ✨🎀🦋