This is the Bacula documentation directory.
Build instructions:
See the file README.pct for more details of the
build system. Note, all the previous xxx.in files have
been removed except for one:
manuals/version.tex.in
You normally should not edit that file, rather edit
version.tex, see the end of this file for more on
versions.
You must have at least the following packages loaded:
texlive
texlive-full
latex2html
tetex
inkscape
tex4ht
tex4ht-common
texlive-fonts-extra
texlive-fonts-extra-doc
texlive-generic-extra
texlive-latex3
texlive-metapost
texlive-plain-extra
ttf-dejavu
ttf-dejavu-extra
ttf-lyx
Web site: nothing to build, simply copy the files to the
Web site, then load the documents in the appropriate
places.
English manual:
cd <docs>
make
The above builds all the Bacula English manuals.
At some point in the future, it will also build the
other languages, when they are ready for distribution.
Each subdirectory of manuals/en/xxx contains a subdirectory
named xxx which contains the web version of that particular
manual. The pdf is in manuals/en/xxx/xxx.pdf
German manual:
cd <docs>
make german
Same as above
French manual:
cd <docs>
make french
Same as above:
A distribution is made by exporting the SVN then building everything
and finally tarring it up.
Note: normally this directory is distributed with the correct
version and date. If you want to change it, simply manually
edit <docs>/manuals/version.tex.
If you want to update the version "automatically" or synchronize
it with the source, edit the update_version file and change the
BACULA_SOURCE variable to point to your source file, then
simply enter:
./update_version
#
# 18-jan-2017
# The latex2html tool is now specific for the "manuals building process"
# If you encounter issues with latex2html process please double check
# mktexlsr was run on /var/lib/texmf
warning: kpathsea: /var/lib/texmf/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
warning: kpathsea: /usr/local/share/texmf/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
warning: kpathsea: /usr/share/texmf/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
warning: kpathsea: /usr/share/texlive/texmf-dist/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
kpathsea: Running mktexfmt latex.fmt
warning: kpathsea: /var/lib/texmf/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
warning: kpathsea: /usr/local/share/texmf/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
warning: kpathsea: /usr/share/texmf/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
warning: kpathsea: /usr/share/texlive/texmf-dist/ls-R: No usable entries in ls-R.
warning: kpathsea: See the manual for how to generate ls-R.
tcfmgr: config file `tcfmgr.map' (usually in $TEXMFMAIN/texconfig) not found (ls-R missing?).
#
# Solution is to cd /var/lib/texmf as root and issue a mktexlsr command.