Author: ben
Date: 2007-12-29 16:05:47 -0800 (Sat, 29 Dec 2007)
New Revision: 7680

Modified:
   openlaszlo/trunk/docs/src/build.xml
   openlaszlo/trunk/docs/src/developers/index.dbk
   openlaszlo/trunk/docs/src/reference/index.dbk
   openlaszlo/trunk/docs/src/reference/welcome.html
   openlaszlo/trunk/docs/src/xsl/common-html.xsl
   openlaszlo/trunk/docs/src/xsl/conditional-html.xsl
   openlaszlo/trunk/docs/src/xsl/dbk-toc2nav.xsl
   openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
   openlaszlo/trunk/docs/src/xsl/lzx-pretty-print.xsl
   openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl
   openlaszlo/trunk/docs/src/xsl/refguide-html.xsl
Log:
Change 20071229-ben-U by [EMAIL PROTECTED] on 2007-12-29 15:52:35 PST
    in /Users/ben/src/svn/openlaszlo/trunk
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: Added pointers to the documentation about the documentation

Documentation:

Lest the next documentation tool maintainer overlook the words
of wisdom I am tucking away in the chapter about the doctools,
I have inserted pointers to that documentation at the beginning
of many of the key files of the doc build.



Modified: openlaszlo/trunk/docs/src/build.xml
===================================================================
--- openlaszlo/trunk/docs/src/build.xml 2007-12-30 00:03:45 UTC (rev 7679)
+++ openlaszlo/trunk/docs/src/build.xml 2007-12-30 00:05:47 UTC (rev 7680)
@@ -3,10 +3,24 @@
 * Copyright 2001-2007 Laszlo Systems, Inc.  All Rights Reserved.              *
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
+ 
 <!DOCTYPE project [
     <!ENTITY build_opt SYSTEM "file:../../build-tools/build-opt.xml">
 ]>
 
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 <project name="reference" default="build">
     
   &build_opt;

Modified: openlaszlo/trunk/docs/src/developers/index.dbk
===================================================================
--- openlaszlo/trunk/docs/src/developers/index.dbk      2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/developers/index.dbk      2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -4,7 +4,20 @@
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
 <!--DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-                 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"-->
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"-->
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 <book xmlns:xi="http://www.w3.org/2003/XInclude";>
   <?dbhtml dir="developers" ?>
   <?dbhtml filename="index.html" ?>

Modified: openlaszlo/trunk/docs/src/reference/index.dbk
===================================================================
--- openlaszlo/trunk/docs/src/reference/index.dbk       2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/reference/index.dbk       2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -3,6 +3,19 @@
 * Copyright 2006 Laszlo Systems, Inc.  All Rights Reserved.                   *
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
                  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>
 <book xmlns:xi="http://www.w3.org/2003/XInclude";>

Modified: openlaszlo/trunk/docs/src/reference/welcome.html
===================================================================
--- openlaszlo/trunk/docs/src/reference/welcome.html    2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/reference/welcome.html    2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -1,6 +1,18 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
-
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 <html xmlns="http://www.w3.org/1999/xhtml";>
   <head>
     <title>LZX 4.1.x Reference Manual</title>

Modified: openlaszlo/trunk/docs/src/xsl/common-html.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/common-html.xsl       2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/xsl/common-html.xsl       2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -8,7 +8,21 @@
 <!ENTITY nbsp  "&#160;">
 
 ]>
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 
+
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
                 xmlns:exslt="http://exslt.org/common";
                 xmlns:dyn="http://exslt.org/dynamic";

Modified: openlaszlo/trunk/docs/src/xsl/conditional-html.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/conditional-html.xsl  2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/xsl/conditional-html.xsl  2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -3,6 +3,19 @@
 * Copyright 2001-2007 Laszlo Systems, Inc.  All Rights Reserved.              *
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 <!DOCTYPE xsl:stylesheet [
 
 <!ENTITY lowercase      "'abcdefghijklmnopqrstuvwxyz'">

Modified: openlaszlo/trunk/docs/src/xsl/dbk-toc2nav.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/dbk-toc2nav.xsl       2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/xsl/dbk-toc2nav.xsl       2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -9,6 +9,8 @@
 
 ]>
 
+<!-- This stylesheet is unused. [bshine 12.26.2007] -->
+
 <xsl:stylesheet version="1.0" 
                 xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
                 xmlns:h="http://www.w3.org/1999/xhtml";

Modified: openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl        2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl        2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -3,6 +3,19 @@
 * Copyright 2001-2007 Laszlo Systems, Inc.  All Rights Reserved.              *
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 <!DOCTYPE xsl:stylesheet [
 
 <!ENTITY nbsp  "&#160;">

Modified: openlaszlo/trunk/docs/src/xsl/lzx-pretty-print.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/lzx-pretty-print.xsl  2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/xsl/lzx-pretty-print.xsl  2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -4,8 +4,20 @@
 
 If you edit this file, please validate your work using http://validator.w3.org/
 -->
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 
-
 <!DOCTYPE xsl:stylesheet [
 
 <!ENTITY constraint    "(starts-with(normalize-space(.),'$') and

Modified: openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl        2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl        2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -3,6 +3,19 @@
 * Copyright 2007 Laszlo Systems, Inc.  All Rights Reserved.                   *
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
+<!-- 
+  To understand the documentation toolchain, please consult the developer's 
guide, 
+  in Part XI, Documentation Tools and Guidelines, and especially in 
+  Chapter 52, The Documentation Toolchain. 
+  
+  In a source build of OpenLaszlo, those chapters can be found at
+  http://localhost:8080/trunk/docs/developers/developers.doctools.html
+  
+  Currently, those chapters can be found live at the following URL
+  
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+  
+  [bshine 12.29.2007]
+-->
 <!DOCTYPE xsl:stylesheet [
 
 ]>

Modified: openlaszlo/trunk/docs/src/xsl/refguide-html.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/refguide-html.xsl     2007-12-30 00:03:45 UTC 
(rev 7679)
+++ openlaszlo/trunk/docs/src/xsl/refguide-html.xsl     2007-12-30 00:05:47 UTC 
(rev 7680)
@@ -3,6 +3,19 @@
 * Copyright 2006-2007 Laszlo Systems, Inc.  All Rights Reserved.              *
 * Use is subject to license terms.                                            *
 * X_LZ_COPYRIGHT_END ****************************************************** -->
+<!-- 
+     To understand the documentation toolchain, please consult the developer's 
guide, 
+     in Part XI, Documentation Tools and Guidelines, and especially in 
+     Chapter 52, The Documentation Toolchain. 
+     
+     In a source build of OpenLaszlo, those chapters can be found at
+     http://localhost:8080/trunk/docs/developers/developers.doctools.html
+     
+     Currently, those chapters can be found live at the following URL
+     
http://labs.openlaszlo.org/trunk-nightly/docs/developers/developers.doctools.html
+     
+     [bshine 12.29.2007]
+-->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
                 version="1.0">
 


_______________________________________________
Laszlo-checkins mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-checkins

Reply via email to