update version

[bacula/docs] / docs / README

diff --git a/docs/README b/docs/README
index 4a2b20d13298e13c40df945df76a942260e5fc48..f204e3271520a560e8ebfc4c9863fd0dbb10313c 100644 (file)
--- a/docs/README
+++ b/docs/README
@@ -1,56 +1,42 @@
 
-This is the Bacula documentation directory. It currently contains
-the following subdirectories:
-
-  Directory              Contents
-  home-page              The Bacula Web Site
-  manuals                All the manuals
-  manuals/en             English version of the manuals
-  manuals/en/catalog     Catalog 
-             concepts    Concepts
-             console     Console and Operators Guide
-             developers  Developer's guide
-             install     Installation and Configuration Guide
-             problems    Problem Resolution Guide
-             utility     Utility Programs
-
-  manuals/de             German translation of the manual
-  manuals/de/catalog     Catalog 
-             concepts    Concepts
-             console     Console and Operators Guide
-             developers  Developer's guide
-             install     Installation and Configuration Guide
-             problems    Problem Resolution Guide
-             utility     Utility Programs
-
-  manuals/fr             French translation of the manual
-  manuals/fr/catalog     Catalog 
-             concepts    Concepts
-             console     Console and Operators Guide
-             developers  Developer's guide
-             install     Installation and Configuration Guide
-             problems    Problem Resolution Guide
-             utility     Utility Programs
-
-  techlogs           Technical development logs
+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.
+
+For latex2html to find latex/, you may need:
+
+export TEXINPUTS=`pwd`/latex
+
 You must have at least the following packages loaded:
 latex2html
 te_latex
 tetex
+libhtml-parser-perl
+libhtml-treebuilder-libxml-perl
+
+instead of the full tex package, you can load:
 
-First, you must do:
+texlive-base
+texlive-fonts-recommended
+texlive-latex-recommended
 
-  cd <docs>
-  ./configure --with-bacula=<path-to-bacula-source>
+I tend to load pretty much everything with the following apt packages:
 
-  This will find the current Bacula version, and create
-  all the Makefiles from Makefile.in  
+dvipdfmx texlive latex2html
 
-  Do not edit the Makefiles or your changes will be lost. Always
-  edit Makefile.in
+and for rpms:
+
+tetex tetex-dvips tetx-fonds tetx-latex
 
 Web site:  nothing to build, simply copy the files to the
            Web site, then load the documents in the appropriate
@@ -69,6 +55,10 @@ English manual:
    named xxx which contains the web version of that particular
    manual.  The pdf is in manuals/en/xxx/xxx.pdf
 
+  NOTE!!! Please note that running multiple simultaneous makes does
+   not work.  I.e. "make -j3" will fail.  If you have a solution, please
+   send it to me.  Thanks.
+
 German manual:
    cd <docs>
    make german
@@ -81,3 +71,14 @@ French manual:
 
 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