From a4f2228675c6d4dd7001fd290447255360d4a5de Mon Sep 17 00:00:00 2001 From: Michael Orlitzky Date: Sat, 28 Feb 2026 14:41:55 -0500 Subject: [PATCH] README.rst: include a separate paragraph for BIBINPUTS The use of an external reference database isn't really a mjotex thing, but we support it via another (previously unmentioned) environment variable. --- README.rst | 30 ++++++++++++++++++++++++------ 1 file changed, 24 insertions(+), 6 deletions(-) diff --git a/README.rst b/README.rst index ad3c5ff..36a1adf 100644 --- a/README.rst +++ b/README.rst @@ -118,10 +118,28 @@ These variables are as follows: *not* located at build time; they must resolve relative to your project. Default unset. -The absolute paths to the ``BIBS`` and ``MJOTEX`` entries are -determined at build time using ``kpsewhich`` from the `kpathsea suite +The absolute paths to the ``MJOTEX`` entries are determined at build +time using ``kpsewhich`` from the `kpathsea suite `_. This makes it possible -to maintain one copy of the mjotex repository and/or one bibliography -database, independent of your papers and presentations; but for it to -work, those entries must live on your TeX path. See the "Installation" -section for that. +to maintain one copy of the mjotex repository independent of your +papers and presentations; but for it to work, those entries must live +on your TeX path. The "Installation" section covers this via the +``TEXINPUTS`` and ``BSTINPUTS`` variables, for ``mjo-*.tex`` and +``mjo.bst`` respectively. + +Though it has little to do with mjotex *per se*, to avoid duplication +it is convenient to use an central (external) reference database as +well. To facilitate this, the entries in ``BIBS`` are also located at +build time, and again they must live on the appropriate TeX path. Now +it is the ``BIBINPUTS`` environment variable that must be set. In your +``~/.bashrc``: + +.. code-block:: shell + + export BIBINPUTS="${BIBINPUTS}:/path/to/your/references" + +Or in your copy of ``GNUmakefile``: + +.. code-block:: make + + export BIBINPUTS := $(BIBINPUTS):/path/to/your/references -- 2.51.0