From: Kern Sibbald <kern@sibbald.com>
Date: Tue, 17 May 2005 09:05:15 +0000 (+0000)
Subject: Build latest manual + build developer's manual + update site
X-Git-Tag: Release-1.38.0~448
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=8b945dc58285165665c35523324773504526b8f2;p=bacula%2Fdocs

Build latest manual + build developer's manual + update site
---

diff --git a/docs/developers/Makefile b/docs/developers/Makefile
index 47e93ad8..f839a2db 100644
--- a/docs/developers/Makefile
+++ b/docs/developers/Makefile
@@ -77,6 +77,7 @@ tex:
 
 devtex:
 	@cp -fp ${IMAGES}/hires/*.eps .
+	touch developers.idx developersi-general.tex
 	-latex -interaction=batchmode developers.tex
 	makeindex developers.idx >/dev/null 2>/dev/null
 	-latex -interaction=batchmode developers.tex
@@ -146,9 +147,9 @@ devweb:
 	@rm -f developers/*
 	@cp -fp ${IMAGES}/*.eps .
 	@rm -f next.eps next.png prev.eps prev.png up.eps up.png
-	@cp -fp ${IMAGES}/*.eps ${IMAGES}/*.png *.txt developers
+	@cp -fp ${IMAGES}/*.eps ${IMAGES}/*.png developers/
 	@rm -f developers/next.eps developers/next.png developers/prev.eps developers/prev.png developers/up.eps developers/up.png
-	latex2html -split 5 -local_icons -t "Developer's Guide" -auto_nav -long_titles 4 \
+	latex2html -split 5 -local_icons -t "Developer's Guide" -long_titles 4 \
 		-contents_in_nav -toc_stars -white -notransparent developers >/dev/null
 	./translate_images.pl developers/Developers_Guide.html
 	@cp -f developers/Developers_Guide.html developers/index.html
diff --git a/docs/developers/developers.tex b/docs/developers/developers.tex
index 20cf5287..6edc6793 100644
--- a/docs/developers/developers.tex
+++ b/docs/developers/developers.tex
@@ -14,6 +14,7 @@
 
 
 \makeindex
+\newindex{general}{idx}{ind}{General Index}
 
 \sloppy
 
diff --git a/docs/home-page/pages/documentation.php b/docs/home-page/pages/documentation.php
index 5f95b83d..820c4acc 100644
--- a/docs/home-page/pages/documentation.php
+++ b/docs/home-page/pages/documentation.php
@@ -37,9 +37,9 @@
        &nbsp;
    <ul>
    <li> <a href="dev-manual/index.html" >HTML Development Manual</a>
-    <br>(development version of the User's manual)<br></li>
+    <br>(User's manual for code under development)<br></li>
    <li> <a href="<? echo $spath ?>/dev-bacula.pdf">PDF Development Manual</a>
-    <br>(development version of the User's Manual)</li>
+    <br>(User's Manual for code under development)</li>
    </ul>
    </td>
    </tr>
@@ -47,8 +47,10 @@
    <tr>
      <td class="content">
        &nbsp;
-       <ul>
-          <li><a href="developers/index.html"> Developer's Guide</a>
+      <ul>
+      <li><a href="developers/index.html">HTML Developer's Guide</a>
+      <br>(Guide for Bacula developers)</li>
+      <li> <a href="<? echo $spath ?>/developers.pdf">PDF Developer's Guide</a>
       <br>(Guide for Bacula developers)</li>
       </ul>
      </td>
diff --git a/docs/manual/Makefile b/docs/manual/Makefile
index e878c52f..1144a941 100644
--- a/docs/manual/Makefile
+++ b/docs/manual/Makefile
@@ -77,6 +77,7 @@ tex:
 
 devtex:
 	@cp -fp ${IMAGES}/hires/*.eps .
+	touch developers.idx developersi-general.tex
 	-latex -interaction=batchmode developers.tex
 	makeindex developers.idx >/dev/null 2>/dev/null
 	-latex -interaction=batchmode developers.tex
@@ -86,6 +87,8 @@ pdf:
 	@echo "Making pdfm"
 	@cp -fp ${IMAGES}/hires/*.eps .
 	dvipdfm -p a4 bacula.dvi
+# Rename for loading on Web site
+	mv bacula.pdf dev-bacula.pdf
 	@rm -f *.eps *.old
 
 dvipdf:
@@ -146,9 +149,9 @@ devweb:
 	@rm -f developers/*
 	@cp -fp ${IMAGES}/*.eps .
 	@rm -f next.eps next.png prev.eps prev.png up.eps up.png
-	@cp -fp ${IMAGES}/*.eps ${IMAGES}/*.png *.txt developers
+	@cp -fp ${IMAGES}/*.eps ${IMAGES}/*.png developers/
 	@rm -f developers/next.eps developers/next.png developers/prev.eps developers/prev.png developers/up.eps developers/up.png
-	latex2html -split 5 -local_icons -t "Developer's Guide" -auto_nav -long_titles 4 \
+	latex2html -split 5 -local_icons -t "Developer's Guide" -long_titles 4 \
 		-contents_in_nav -toc_stars -white -notransparent developers >/dev/null
 	./translate_images.pl developers/Developers_Guide.html
 	@cp -f developers/Developers_Guide.html developers/index.html
diff --git a/docs/manual/requirements.tex b/docs/manual/requirements.tex
index 74092549..6eae1088 100644
--- a/docs/manual/requirements.tex
+++ b/docs/manual/requirements.tex
@@ -19,7 +19,7 @@
    Solaris systems. 
 \item It requires GNU C++ version 2.95 or higher to compile. You can try  with
    other compilers and older versions, but you are on your own.  We have
-   successfully compiled and used Bacula on RH8.0/RH9/RHEL 3.0  with GCC 3.2.
+   successfully compiled and used Bacula on RH8.0/RH9/RHEL 3.0/FC3  with GCC 3.4.
 Note, in general GNU C++ is a separate package (e.g.  RPM) from GNU C, so you
 need them both loaded. On RedHat systems,  the C++ compiler is part of the
 {\bf gcc-c++} rpm package. 
@@ -38,9 +38,9 @@ need them both loaded. On RedHat systems,  the C++ compiler is part of the
    also runs under GNOME 1.4 but this version is deprecated and  thus no longer
    maintained. 
 \item The wxWidgets Console program is developed and tested with the latest 
-   stable version of 
-   \elink{wxWidgets}{http://www.wxwidgets.org/} (2.4.2).  It works fine with the
-Windows and GTK+-1.x version of wxWidgets, and should  also work on other
+   stable ANSI (not Unicode) version of 
+   \elink{wxWidgets}{http://www.wxwidgets.org/} (2.6.0).  It works fine with the
+Windows and GTK+-2.x version of wxWidgets, and should  also work on other
 platforms supported by wxWidgets. 
 \item The Tray Monitor program is developed for GTK+-2.x. It needs  Gnome less
    or equal to 2.2, KDE greater or equal to 3.1 or any window manager supporting
diff --git a/docs/manual/supported.tex b/docs/manual/supported.tex
index 6ba2ff3d..5550283f 100644
--- a/docs/manual/supported.tex
+++ b/docs/manual/supported.tex
@@ -19,7 +19,7 @@
 Solaris systems. 
 \item It requires GNU C++ version 2.95 or higher to compile. You can try  with
 other compilers and older versions, but you are on your own.  We have
-successfully compiled and used Bacula on RH8.0/RH9/RHEL 3.0  with GCC 3.2.
+successfully compiled and used Bacula on RH8.0/RH9/RHEL 3.0/FC3  with GCC 3.4.
 Note, in general GNU C++ is a separate package (e.g.  RPM) from GNU C, so you
 need them both loaded. On RedHat systems,  the C++ compiler is part of the
 {\bf gcc-c++} rpm package. 
@@ -38,9 +38,9 @@ should be relatively easy.
 also runs under GNOME 1.4 but this version is deprecated and  thus no longer
 maintained. 
 \item The wxWidgets Console program is developed and tested with the latest 
-stable version of 
-\elink{wxWidgets}{http://www.wxwidgets.org/} (2.4.2).  It works fine with the
-Windows and GTK+-1.x version of wxWidgets, and should  also works on other
+stable ANSI (not Unicode) version of 
+\elink{wxWidgets}{http://www.wxwidgets.org/} (2.6.0).  It works fine with the
+Windows and GTK+-2.x version of wxWidgets, and should  also works on other
 platforms supported by wxWidgets. 
 \item The Tray Monitor program is developed for GTK+-2.x. It needs  Gnome less
 or equal to 2.2, KDE greater or equal to 3.1 or any window manager supporting
@@ -62,7 +62,7 @@ install the
 \addcontentsline{toc}{subsection}{Supported Operating Systems}
 
 \begin{itemize}
-\item Linux systems (built and tested on RedHat Enterprise Linux 3.0).  
+\item Linux systems (built and tested on RedHat Fedora Core 3).  
 \item If you have a recent Red Hat Linux system running the 2.4.x kernel  and
 you have the directory {\bf /lib/tls} installed on your  system (normally by
 default), bacula will {\bf NOT} run. This is  the new pthreads library and it
@@ -74,9 +74,12 @@ variable ``LD\_ASSUME\_KERNEL=2.4.19'' prior to  executing Bacula. For this
 option, you do not need to reboot, and  all programs other than Bacula will
 continue to use /lib/tls.  
 
-The feedback that we have for 2.6 kernels is that the  same problem exists.
-However, on 2.6 kernels, we would  probably recommend using the environment
-variable override  (LD\_ASSUME\_KERNEL=2.4.19) rather than removing /lib/tls. 
+The feedback that we have for 2.6 kernels is that the same problem may
+exist.  However, we have not been able to reproduce the above mentioned
+problem (bizarre hangs) on 2.6 kernels.  If you do experience problems, we
+recommend using the environment variable override
+(LD\_ASSUME\_KERNEL=2.4.19) rather than removing /lib/tls, because TLS
+is designed to work with 2.6 kernels.
 
 \item Most flavors of Linux (Gentoo, SuSE, Mandrake, Debian, ...).  
 \item Solaris various versions.