| 1 |
|
| 2 |
This is the Bacula documentation directory. |
| 3 |
|
| 4 |
Build instructions: |
| 5 |
|
| 6 |
See the file README.pct for more details of the |
| 7 |
build system. Note, all the previous xxx.in files have |
| 8 |
been removed except for one: |
| 9 |
|
| 10 |
manuals/version.tex.in |
| 11 |
|
| 12 |
You normally should not edit that file, rather edit |
| 13 |
version.tex, see the end of this file for more on |
| 14 |
versions. |
| 15 |
|
| 16 |
You must have at least the following packages loaded: |
| 17 |
texlive |
| 18 |
texlive-full |
| 19 |
latex2html |
| 20 |
tetex |
| 21 |
inkscape |
| 22 |
tex4ht |
| 23 |
tex4ht-common |
| 24 |
texlive-fonts-extra |
| 25 |
texlive-fonts-extra-doc |
| 26 |
texlive-generic-extra |
| 27 |
texlive-latex3 |
| 28 |
texlive-metapost |
| 29 |
texlive-plain-extra |
| 30 |
ttf-dejavu |
| 31 |
ttf-dejavu-extra |
| 32 |
ttf-lyx |
| 33 |
|
| 34 |
Web site: nothing to build, simply copy the files to the |
| 35 |
Web site, then load the documents in the appropriate |
| 36 |
places. |
| 37 |
|
| 38 |
|
| 39 |
English manual: |
| 40 |
cd <docs> |
| 41 |
make |
| 42 |
|
| 43 |
The above builds all the Bacula English manuals. |
| 44 |
At some point in the future, it will also build the |
| 45 |
other languages, when they are ready for distribution. |
| 46 |
|
| 47 |
Each subdirectory of manuals/en/xxx contains a subdirectory |
| 48 |
named xxx which contains the web version of that particular |
| 49 |
manual. The pdf is in manuals/en/xxx/xxx.pdf |
| 50 |
|
| 51 |
German manual: |
| 52 |
cd <docs> |
| 53 |
make german |
| 54 |
Same as above |
| 55 |
|
| 56 |
French manual: |
| 57 |
cd <docs> |
| 58 |
make french |
| 59 |
Same as above: |
| 60 |
|
| 61 |
A distribution is made by exporting the SVN then building everything |
| 62 |
and finally tarring it up. |
| 63 |
|
| 64 |
Note: normally this directory is distributed with the correct |
| 65 |
version and date. If you want to change it, simply manually |
| 66 |
edit <docs>/manuals/version.tex. |
| 67 |
|
| 68 |
If you want to update the version "automatically" or synchronize |
| 69 |
it with the source, edit the update_version file and change the |
| 70 |
BACULA_SOURCE variable to point to your source file, then |
| 71 |
simply enter: |
| 72 |
|
| 73 |
./update_version |
| 74 |
|
| 75 |
# |
| 76 |
# 18-jan-2017 |
| 77 |
# The latex2html tool is now specific for the "manuals building process" |
| 78 |
# If you encounter issues with latex2html process please double check |
| 79 |
# mktexlsr was run on /var/lib/texmf |
| 80 |
warning: kpathsea: /var/lib/texmf/ls-R: No usable entries in ls-R. |
| 81 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 82 |
warning: kpathsea: /usr/local/share/texmf/ls-R: No usable entries in ls-R. |
| 83 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 84 |
warning: kpathsea: /usr/share/texmf/ls-R: No usable entries in ls-R. |
| 85 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 86 |
warning: kpathsea: /usr/share/texlive/texmf-dist/ls-R: No usable entries in ls-R. |
| 87 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 88 |
|
| 89 |
kpathsea: Running mktexfmt latex.fmt |
| 90 |
warning: kpathsea: /var/lib/texmf/ls-R: No usable entries in ls-R. |
| 91 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 92 |
warning: kpathsea: /usr/local/share/texmf/ls-R: No usable entries in ls-R. |
| 93 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 94 |
warning: kpathsea: /usr/share/texmf/ls-R: No usable entries in ls-R. |
| 95 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 96 |
warning: kpathsea: /usr/share/texlive/texmf-dist/ls-R: No usable entries in ls-R. |
| 97 |
warning: kpathsea: See the manual for how to generate ls-R. |
| 98 |
tcfmgr: config file `tcfmgr.map' (usually in $TEXMFMAIN/texconfig) not found (ls-R missing?). |
| 99 |
# |
| 100 |
# Solution is to cd /var/lib/texmf as root and issue a mktexlsr command. |