]> git.sur5r.net Git - bacula/docs/commitdiff
Build latest manual + build developer's manual + update site
authorKern Sibbald <kern@sibbald.com>
Tue, 17 May 2005 09:05:15 +0000 (09:05 +0000)
committerKern Sibbald <kern@sibbald.com>
Tue, 17 May 2005 09:05:15 +0000 (09:05 +0000)
docs/developers/Makefile
docs/developers/developers.tex
docs/home-page/pages/documentation.php
docs/manual/Makefile
docs/manual/requirements.tex
docs/manual/supported.tex

index 47e93ad865d3e1e5e12be2b303cf8bf2be9d1bf0..f839a2db3b8b9e3e66fbae06c466e8e5a3b64aac 100644 (file)
@@ -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
index 20cf5287f483c59a8b447e2e0e97741199e7d151..6edc6793714926388999fb744d76074869ed0fd2 100644 (file)
@@ -14,6 +14,7 @@
 
 
 \makeindex
+\newindex{general}{idx}{ind}{General Index}
 
 \sloppy
 
index 5f95b83dfb346c1278286764b115090eb38812cd..820c4acc1a8c9dbb829865a28786e5071730c5dc 100644 (file)
@@ -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>
    <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>
index e878c52f37b6248e83d1dff6895a62a0c019b86d..1144a94128fdf9ff8627824d364682e35ace2084 100644 (file)
@@ -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
index 74092549e0c5af9bc45f206dcda7730510048e06..6eae1088d479eb5a1d7d00673c1b4e2798a68b7c 100644 (file)
@@ -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
index 6ba2ff3dfed1086318da79876d3366bf23eab7b5..5550283fc98b6c0dd672b587beb1c06558efa2ee 100644 (file)
@@ -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.