
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.
