This patch fix the bug referenced as https://bugs.baculasystems.com/view.php?id=23...

[bacula/docs] / docs / README.pct

diff --git a/docs/README.pct b/docs/README.pct
index c38fd237f60377b6c8df5fbef569d75d92c1293b..1c20824e504e5ddaf7ecc78f941586de34456671 100644 (file)
--- a/docs/README.pct
+++ b/docs/README.pct
@@ -7,6 +7,8 @@ Philippe Chauvat
 ---
 24-octobre-2013: Known bug: Currently, the perl 5.18.1 version has a bug which
                           have a big impact on latex2html
+---
+25-octobre-2013: HTML external references added.
 
 What has changed?
 =================
@@ -88,8 +90,7 @@ appropriate files and because references are used over several manuals,
 this process must be ran over all the manuals, whatever the actual manual
 on which the modification(s) is (are) made.
 
-Restriction: External references process does not work for the HTML
-             documentation.
+External references are now managed.
 
 How it works?
 -------------
@@ -103,6 +104,13 @@ Where:
 e.g:
 \externaldocument[main-]{../main/quickstart}
 
+With HTML, the process is defined by:
+- finding into the original LaTeX code the \bsysxrling{$1}{$2}{$3}{$4} macro
+- replacing them by __XRANCHOR_$1_$2_$3_$4__ 
+- modifications made into the translatedoc.pl script (see. docs/tools/README)
+- calling the handle-xr-references.pl script at the end of htmls.sh script
+  (see docs/tools/README)
+
 COVERPAGE MANAGEMENT
 ====================
 The source coverpage file for a manual is located into the docs/covers/svg