Author: ben
Date: 2007-12-20 21:17:26 -0800 (Thu, 20 Dec 2007)
New Revision: 7649
Added:
openlaszlo/trunk/docs/src/developers/branch-management.dbk
openlaszlo/trunk/docs/src/developers/change-submission.dbk
openlaszlo/trunk/docs/src/developers/doc-toolchain.dbk
openlaszlo/trunk/docs/src/developers/docbook-code.dbk
openlaszlo/trunk/docs/src/developers/docbook-local.dbk
openlaszlo/trunk/docs/src/developers/images/doc-toolchain.graffle
openlaszlo/trunk/docs/src/developers/images/doc-toolchain.png
openlaszlo/trunk/docs/src/developers/js2doc-local.dbk
openlaszlo/trunk/docs/src/developers/js2doc-ref.dbk
openlaszlo/trunk/docs/src/developers/licenses.dbk
openlaszlo/trunk/docs/src/developers/release-management.dbk
openlaszlo/trunk/docs/src/developers/source-build.dbk
Removed:
openlaszlo/trunk/docs/src/contributors/branch-management.dbk
openlaszlo/trunk/docs/src/contributors/change-submission.dbk
openlaszlo/trunk/docs/src/contributors/doc-toolchain.dbk
openlaszlo/trunk/docs/src/contributors/docbook-code.dbk
openlaszlo/trunk/docs/src/contributors/docbook-local.dbk
openlaszlo/trunk/docs/src/contributors/images/doc-toolchain.graffle
openlaszlo/trunk/docs/src/contributors/images/doc-toolchain.png
openlaszlo/trunk/docs/src/contributors/js2doc-local.dbk
openlaszlo/trunk/docs/src/contributors/js2doc-ref.dbk
openlaszlo/trunk/docs/src/contributors/licenses.dbk
openlaszlo/trunk/docs/src/contributors/release-management.dbk
openlaszlo/trunk/docs/src/contributors/source-build.dbk
Modified:
openlaszlo/trunk/docs/src/build.xml
openlaszlo/trunk/docs/src/developers/index.dbk
Log:
Change 20071220-ben-S by [EMAIL PROTECTED] on 2007-12-20 21:05:22 PST
in /Users/ben/src/svn/openlaszlo/trunk
for http://svn.openlaszlo.org/openlaszlo/trunk
Summary: Move chapters from contributor's guide into developer's guide
New Features: Chapters in devguide on doc toolchain, source build, licenses
Technical Reviewer: (pending)
QA Reviewer: (pending)
Doc Reviewer: (pending)
Documentation:
Several good chapters were hiding away in the contributors/ directory,
never making it into the shipped documentation. This change moves
the tasty chapters into the developer's guide, and adds them to
developers/index.dbk so they are included in the developer's
guide. These chapters are mostly incomplete, but they contain
useful information even so.
This change also adds an appendix listing all the components
of the distribution, and the associated licenses.
This change also consolidates several sections of the
developer's guide which each had one chapter into a single
section, which I've called "Advanced Topics."
Release Notes:
Details:
Tests:
Modified: openlaszlo/trunk/docs/src/build.xml
===================================================================
--- openlaszlo/trunk/docs/src/build.xml 2007-12-21 05:14:16 UTC (rev 7648)
+++ openlaszlo/trunk/docs/src/build.xml 2007-12-21 05:17:26 UTC (rev 7649)
@@ -1126,6 +1126,7 @@
<copy todir="${developers.build.dir}">
<fileset dir="${developers.input.dir}"/>
</copy>
+ <copy todir="${developers.build.dir}"
file="${lps.server.dir}/lib/js2doc.rnc"/>
</target>
<target name="developers.resources" depends="developers.preprocess">
Deleted: openlaszlo/trunk/docs/src/contributors/branch-management.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/change-submission.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/doc-toolchain.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/docbook-code.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/docbook-local.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/images/doc-toolchain.graffle
Deleted: openlaszlo/trunk/docs/src/contributors/images/doc-toolchain.png
Deleted: openlaszlo/trunk/docs/src/contributors/js2doc-local.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/js2doc-ref.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/licenses.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/release-management.dbk
Deleted: openlaszlo/trunk/docs/src/contributors/source-build.dbk
Copied: openlaszlo/trunk/docs/src/developers/branch-management.dbk (from rev
7645, openlaszlo/trunk/docs/src/contributors/branch-management.dbk)
Copied: openlaszlo/trunk/docs/src/developers/change-submission.dbk (from rev
7645, openlaszlo/trunk/docs/src/contributors/change-submission.dbk)
Copied: openlaszlo/trunk/docs/src/developers/doc-toolchain.dbk (from rev 7645,
openlaszlo/trunk/docs/src/contributors/doc-toolchain.dbk)
Copied: openlaszlo/trunk/docs/src/developers/docbook-code.dbk (from rev 7645,
openlaszlo/trunk/docs/src/contributors/docbook-code.dbk)
Copied: openlaszlo/trunk/docs/src/developers/docbook-local.dbk (from rev 7645,
openlaszlo/trunk/docs/src/contributors/docbook-local.dbk)
Copied: openlaszlo/trunk/docs/src/developers/images/doc-toolchain.graffle (from
rev 7645, openlaszlo/trunk/docs/src/contributors/images/doc-toolchain.graffle)
Copied: openlaszlo/trunk/docs/src/developers/images/doc-toolchain.png (from rev
7645, openlaszlo/trunk/docs/src/contributors/images/doc-toolchain.png)
Modified: openlaszlo/trunk/docs/src/developers/index.dbk
===================================================================
--- openlaszlo/trunk/docs/src/developers/index.dbk 2007-12-21 05:14:16 UTC
(rev 7648)
+++ openlaszlo/trunk/docs/src/developers/index.dbk 2007-12-21 05:17:26 UTC
(rev 7649)
@@ -85,27 +85,19 @@
<!-- xi:include href="dataprovider.dbk"/ -->
</part>
- <part id="developers.media">
- <title>Media</title>
+ <part id="developers.advanced">
+ <title>Advanced Topics</title>
+ <xi:include href="survey-chapter.dbk"/>
<xi:include href="video.dbk"/>
+ <xi:include href="performance.dbk"/>
+ <xi:include href="cookies.dbk"/>
</part>
- <part id="developers.application">
- <title>Examining Applications</title>
- <xi:include href="survey-chapter.dbk"/>
- </part>
- <part id="developers.performance">
- <title>Performance Monitoring and Tuning</title>
- <!--xi:include href="data-pooling.dbk"/-->
- <xi:include href="performance.dbk"/>
- <?ignore <chapter id="colors"><title>Color in Laszlo
Applications</title></chapter>?>
- </part>
-
+ <?ignore
<part id="developers.server-integration">
<title>Server Integration</title>
<!--xi:include href="integrating-existing.dbk"/-->
- <xi:include href="cookies.dbk"/>
<!--xi:include href="persistent_connection.dbk"/-->
<!--xi:include href="logging.dbk"/-->
<!--xi:include href="lps-request-types.dbk"/-->
@@ -113,6 +105,7 @@
<!--xi:include href="deployers-guide.dbk"/-->
<!--xi:include href="caching.dbk"/-->
</part>
+ ?>
<?part id="developers.advanced">
<title>Power Programming in LZX</title>
@@ -138,12 +131,39 @@
<xi:include href="editing-lzx.dbk"/>
<xi:include href="debugging.dbk"/>
<xi:include href="lzunit.dbk"/>
+ <xi:include href="source-build.dbk">
+ <xi:fallback><para>Missing: Building from Source</para></xi:fallback>
+ </xi:include>
+ </part>
+
+ <part id="developers.doctools">
+ <title>Documentation Tools and Guidelines</title>
+
+ <xi:include href="doc-toolchain.dbk">
+ <xi:fallback><para>Missing: Doc Tool Chain</para></xi:fallback>
+ </xi:include>
+
+ <xi:include href="docbook-local.dbk">
+ <xi:fallback><para>Missing: Docbook Local Style
Guide</para></xi:fallback>
+ </xi:include>
+
+ <xi:include href="docbook-code.dbk">
+ <xi:fallback><para>Missing: Docbook Code Comment Style
Guide</para></xi:fallback>
+ </xi:include>
+
+ <xi:include href="js2doc-ref.dbk">
+ <xi:fallback><para>Missing: JS2Doc Reference</para></xi:fallback>
+ </xi:include>
+
</part>
<part id="developers.appendices">
<title>Appendices</title>
<xi:include href="initialization-and-instantiation.dbk"/>
<xi:include href="ecmascript-and-lzx.dbk"/>
+ <xi:include href="licenses.dbk">
+ <xi:fallback><para>Missing: Licenses Reference</para></xi:fallback>
+ </xi:include>
</part>
<!--index/-->
Copied: openlaszlo/trunk/docs/src/developers/js2doc-local.dbk (from rev 7645,
openlaszlo/trunk/docs/src/contributors/js2doc-local.dbk)
Copied: openlaszlo/trunk/docs/src/developers/js2doc-ref.dbk (from rev 7645,
openlaszlo/trunk/docs/src/contributors/js2doc-ref.dbk)
Copied: openlaszlo/trunk/docs/src/developers/licenses.dbk (from rev 7645,
openlaszlo/trunk/docs/src/contributors/licenses.dbk)
Copied: openlaszlo/trunk/docs/src/developers/release-management.dbk (from rev
7645, openlaszlo/trunk/docs/src/contributors/release-management.dbk)
Copied: openlaszlo/trunk/docs/src/developers/source-build.dbk (from rev 7645,
openlaszlo/trunk/docs/src/contributors/source-build.dbk)
_______________________________________________
Laszlo-checkins mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-checkins
