cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r377949 [21/21] - in /cocoon/site/site/2.1: ./ developing/ developing/portal/ developing/portal/coplets/ developing/webapps/ developing/webapps/authentication/ faq/ howto/ installing/ plan/documentation/ plan/otherplanning/ plan/overview/ s...
Date Wed, 15 Feb 2006 06:36:23 GMT
Modified: cocoon/site/site/2.1/userdocs/xsp/xsp-internals.html
--- cocoon/site/site/2.1/userdocs/xsp/xsp-internals.html (original)
+++ cocoon/site/site/2.1/userdocs/xsp/xsp-internals.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
   |alternative credits
-<div id="credit2">
-<a href=""><img border="0" title="ApacheCon US 2005" alt="ApacheCon
US 2005 - logo" src="" style="width: 125px;height:
+<div id="credit2"></div>
     |end Menu
@@ -1269,7 +1267,7 @@
-<a name="N10047"></a><a name="Markup-to-code+Transformation"></a>
+<a name="N10047"></a><a name="markup-to-code"></a>
 <h2 class="h3">Markup-to-code Transformation</h2>
 <div class="section">
 <p>XSP is based on a general-purpose markup-to-code transformation engine built
@@ -1309,14 +1307,14 @@
-<a name="N1007C"></a><a name="XSP+and+Cocoon+Generators"></a>
+<a name="N1007D"></a><a name="cocoon-generators"></a>
 <h2 class="h3">XSP and Cocoon Generators</h2>
 <div class="section">
 <p>As a rule, XSP pages are translated into Cocoon
 <a href="apidocs/org/apache/cocoon/generation/Generator.html">
 <tt>Generator</tt>'s. </a>
-<a name="N10088"></a><a name="Server+Pages+Generator+Proxy"></a>
+<a name="N1008A"></a><a name="Server+Pages+Generator+Proxy"></a>
 <h3 class="h4">Server Pages Generator Proxy</h3>
 <tt>Generator</tt>'s created by XSP are invoked exclusively through
@@ -1391,7 +1389,7 @@
 <p>The complete XSP sitemap configuration is explained
 <a href="#sitemap-configuration">below</a>.</p>
-<a name="N100DD"></a><a name="XSP+Generators+and+Compiled+Languages"></a>
+<a name="N100DF"></a><a name="XSP+Generators+and+Compiled+Languages"></a>
 <h3 class="h4">XSP Generators and Compiled Languages</h3>
 <p>For the Java language (and other compiled languages like
 <a class="external" href=""><em>Rhino</em></a>
Javascript), XSP
@@ -1435,7 +1433,7 @@
 methods used to shorten the generation of SAX events not requiring a namespace.
-<a name="N1014B"></a><a name="The+Programming+Language+Processor"></a>
+<a name="N1014D"></a><a name="programming-language"></a>
 <h2 class="h3">The Programming Language Processor</h2>
 <div class="section">
 <p>A Cocoon's
@@ -1475,7 +1473,7 @@
 <tt>AbstractProgrammingLanguage</tt> </a>) is provided that extends
 <tt>org.apache.arch.named.AbstractNamedComponent</tt> and retrieves
 language-related sitemap parameters.</p>
-<a name="N1018B"></a><a name="Filenames+and+Encoding"></a>
+<a name="N1018E"></a><a name="Filenames+and+Encoding"></a>
 <h3 class="h4">Filenames and Encoding</h3>
 <tt>load</tt> and <tt>unload</tt> are passed a file/directory pair
used to
@@ -1502,7 +1500,7 @@
 <p>Finally, the (optional) <tt>encoding</tt> argument specifies the how
 source program file contents are encoded. This argument can be <tt>null</tt>
 specify the platform's default encoding.</p>
-<a name="N101D5"></a><a name="Loading+Programs"></a>
+<a name="N101D8"></a><a name="Loading+Programs"></a>
 <h3 class="h4">Loading Programs</h3>
 <p>Currently, programs returned by the <tt>load</tt> operation are "plain"
 <tt>Object</tt>'s and are not required to implement any interface or to extend
@@ -1520,7 +1518,7 @@
 <p>Of course, it is an error for the source program file not to exist as a
 readable, regular operating system file.</p>
-<a name="N101F4"></a><a name="Unloading+Programs"></a>
+<a name="N101F8"></a><a name="Unloading+Programs"></a>
 <h3 class="h4">Unloading Programs</h3>
 <p>When a previously loaded program is no longer needed (or becomes "outdated"
 as explained below) the language processor may need to perform cleanup actions,
@@ -1545,7 +1543,7 @@
 instantiation should take place through the program object itself, rather than
 through the language processor (see <em>Program Instantiation</em> below)</div>
-<a name="N1022C"></a><a name="Instantiating+Programs"></a>
+<a name="N10231"></a><a name="Instantiating+Programs"></a>
 <h3 class="h4">Instantiating Programs</h3>
 <p>The <tt>program</tt> object returned by <tt>load</tt> must
act as an factory
 capable of creating <em>program instance</em> objects on demand.</p>
@@ -1561,12 +1559,12 @@
 <tt>prototype</tt> object to <tt>load</tt> as to ensure that created
 conform to a given Java type expected behavior.</div>
-<a name="N10254"></a><a name="Source+Extensions"></a>
+<a name="N1025A"></a><a name="Source+Extensions"></a>
 <h3 class="h4">Source Extensions</h3>
 <p>All languages are required to return a <em>source extension</em>. This
 extension is used to locate source files for subsequent interpretation or
-<a name="N1025D"></a><a name="Code+Formatting"></a>
+<a name="N10264"></a><a name="Code+Formatting"></a>
 <h3 class="h4">Code Formatting</h3>
 <p>Programming languages may provide a
 <a href="apidocs/org/apache/cocoon/components/language/programming/CodeFormatter.html">
@@ -1590,14 +1588,14 @@
 not open-sourced) products like <a class="external" href="">Jindent</a>.
-<a name="N10292"></a><a name="String+Quoting"></a>
+<a name="N1029A"></a><a name="String+Quoting"></a>
 <h3 class="h4">String Quoting</h3>
 <p>Method <tt>quoteString</tt> applies the programming language string
 escaping rules to its input argument.</p>
 <p>This method exists to assist markup language code generators in escaping
 <tt>Text</tt> XML nodes.</p>
-<a name="N102A0"></a><a name="Compiled+Languages"></a>
+<a name="N102A9"></a><a name="compiled-languages"></a>
 <h2 class="h3">Compiled Languages</h2>
 <div class="section">
 <p>Compiled languages extend the <tt>ProgrammingLanguage</tt> abstraction
@@ -1641,20 +1639,20 @@
   . . .
-<a name="N102EB"></a><a name="Object+Extensions"></a>
+<a name="N102F5"></a><a name="Object+Extensions"></a>
 <h3 class="h4">Object Extensions</h3>
 <p>All compiled languages are required to return a <em>source extension</em>.
 This extension is used to locate object files for subsequent loading.</p>
-<a name="N102F4"></a><a name="Object+Program+Loading"></a>
+<a name="N102FF"></a><a name="Object+Program+Loading"></a>
 <h3 class="h4">Object Program Loading</h3>
 <p>Concrete compiled programming languages must implement the abstract method
 <tt>loadProgram</tt> to actually load an <em>object</em> program
resulting from
-<a name="N10300"></a><a name="Program+Compilation"></a>
+<a name="N1030C"></a><a name="Program+Compilation"></a>
 <h3 class="h4">Program Compilation</h3>
 <p>Compilation is delegated to a sitemap-specified <tt>LanguageCompiler</tt>
 instance, as explained below.</p>
-<a name="N10309"></a><a name="Compilers"></a>
+<a name="N10316"></a><a name="Compilers"></a>
 <h3 class="h4">Compilers</h3>
 <a href="apidocs/org/apache/cocoon/components/language/programming/LanguageCompiler.html">
@@ -1692,7 +1690,7 @@
 should compilation fail</li>
-<a name="N10340"></a><a name="Compiler+Errors"></a>
+<a name="N1034E"></a><a name="Compiler+Errors"></a>
 <h4>Compiler Errors</h4>
 <p>Error message producer by the compiler must be collected and massaged by the
 <tt>LanguageCompiler</tt> in order to wrap each of them as a
@@ -1727,7 +1725,7 @@
 <tt>getMessage</tt>. Returns the actual error message text</li>
-<a name="N1037A"></a><a name="Java+Compilers"></a>
+<a name="N10389"></a><a name="Java+Compilers"></a>
 <h4>Java Compilers</h4>
 <p>For the Java language, 2 pluggable compilers are available:</p>
@@ -1743,13 +1741,13 @@
 <a href="apidocs/org/apache/cocoon/components/language/programming/java/AbstractJavaCompiler.html">
 <tt>AbstractJavaCompiler</tt>. </a>
-<a name="N10397"></a><a name="Other+Compilers"></a>
+<a name="N103A7"></a><a name="Other+Compilers"></a>
 <h4>Other Compilers</h4>
 <p>Since <a class="external" href=""><em>Rhino</em></a>
 provides its own, only compiler (<em>jsc</em>), class
 <tt>JavascriptLanguage</tt> doesn't use the compiler class initialized by
-<a name="N103AB"></a><a name="Object+Program+Unloading"></a>
+<a name="N103BC"></a><a name="Object+Program+Unloading"></a>
 <h3 class="h4">Object Program Unloading</h3>
 <tt>CompiledProgrammingLanguage</tt> extends the default implementation
@@ -1767,7 +1765,7 @@
 <p>This is a commonly-used workaround for the (somewhat buggy) standard Java
 class loader, which doesn't provide for an explicit method for reloading class
-<a name="N103CC"></a><a name="The+Cocoon+Class+Loader"></a>
+<a name="N103DE"></a><a name="The+Cocoon+Class+Loader"></a>
 <h3 class="h4">The Cocoon Class Loader</h3>
 <p>To circumvent standard Java class loaders limitation, Cocoon provides a
 simple customized class loader
@@ -1829,7 +1827,7 @@
-<a name="N10428"></a><a name="Interpreted+Languages"></a>
+<a name="N1043B"></a><a name="interpreted-languages"></a>
 <h2 class="h3">Interpreted Languages</h2>
 <div class="section">
 <p>Interpreted languages for which a Java-based interpreter exists are supported
@@ -1881,7 +1879,7 @@
 of the given type.</div>
-<a name="N10477"></a><a name="The+Markup+Language+Processor"></a>
+<a name="N1048B"></a><a name="markup-language"></a>
 <h2 class="h3">The Markup Language Processor</h2>
 <div class="section">
 <p>A Cocoon's
@@ -1955,7 +1953,7 @@
 document nodes. Code generation is being reconsidered, however, to overcome this
 and make it possible to reuse Cocoon's SAX-based filtering pipeline.</div>
-<a name="N104E3"></a><a name="Markup+Encoding"></a>
+<a name="N104F8"></a><a name="Markup+Encoding"></a>
 <h3 class="h4">Markup Encoding</h3>
 <p>All markup languages must provide a way to declare the XML document's
 encoding so that it is preserved during code generation, beautifying and
@@ -1970,7 +1968,7 @@
 to provide access to it, thus forcing server pages authors to redundantly
 specify it.</div>
-<a name="N104F9"></a><a name="The+Logicsheet+class"></a>
+<a name="N1050F"></a><a name="The+Logicsheet+class"></a>
 <h3 class="h4">The Logicsheet class</h3>
 <p>A <em>logicsheet</em> is an XML filter used to translate user-defined
 markup into equivalent code embedding directives for a given markup language.
@@ -2007,9 +2005,9 @@
 used to perform the transformation without an intervening stylesheet processor
 wrapping abstraction.</div>
-<a name="N10531"></a><a name="Named+Logicsheets"></a>
+<a name="N10548"></a><a name="Named+Logicsheets"></a>
 <h3 class="h4">Named Logicsheets</h3>
-<p>As explained in <a href="../../../2.1/"> Logicsheet Concepts,
+<p>As explained in <a href="../../../2.1/userdocs/xsp/logicsheet-concepts.html#logicsheet-object">
Logicsheet Concepts,
 </a> logicsheets are typically associated with a single object type whose
 methods it wraps to make them available as <em>markup commands</em>.</p>
 <p>Markup commands related to a given object type are grouped under a single
@@ -2045,7 +2043,7 @@
 wrongly binds named logicsheets based on their namespace <em>prefix</em>
 instead of their URI!</div>
-<a name="N1057B"></a><a name="Logicsheet+Code+Generators"></a>
+<a name="N10593"></a><a name="Logicsheet+Code+Generators"></a>
 <h3 class="h4">Logicsheet Code Generators</h3>
 <p>Logicsheets translate dynamic tags to equivalent code-embedding directives
 expressed in the markup language at hand. They do not, however, actually emit
@@ -2082,7 +2080,7 @@
 generator abstraction from its logicsheet-based implementation. This would allow
 for alternative code-generation strategies to be plugged.</div>
-<a name="N105B7"></a><a name="Markup+Language+Definition"></a>
+<a name="N105D0"></a><a name="Markup+Language+Definition"></a>
 <h3 class="h4">Markup Language Definition</h3>
 <p>Markup languages are defined in the sitemap as follows:</p>
@@ -2122,14 +2120,14 @@
 <p>Optionally, each supported programming language may define one or more
 namespace-mapped <em>builtin logicsheets</em>.</p>
-<a name="N105D4"></a><a name="The+XSP+Markup+Language"></a>
+<a name="N105EE"></a><a name="xsp-language"></a>
 <h2 class="h3">The XSP Markup Language</h2>
 <div class="section">
 <p>So far, programming and markup languages have been described in general,
 without explicitly referring to the XSP language.</p>
 <p>This section describes how the above described framework is used to implement
 XSP in particular. For a description of logicsheet authoring requirements for
-XSP in Java, see <a href="../../../2.1/"> XSLT Logicsheets and XSP
+XSP in Java, see <a href="../../../2.1/userdocs/xsp/logicsheet-concepts.html#java-logicsheets">
XSLT Logicsheets and XSP
 for Java. </a>
 <div class="frame note">
@@ -2140,7 +2138,7 @@
 pages do not need to embed any code. In this case, there should be no need for
 the <tt>&lt;xsp:page&gt;</tt> element.</div>
-<a name="N105ED"></a><a name="Markup+Encoding-N105ED"></a>
+<a name="N10608"></a><a name="Markup+Encoding-N10608"></a>
 <h3 class="h4">Markup Encoding</h3>
 <p>Method <tt>getEncoding</tt> is implemented by class
 <a href="apidocs/org/apache/cocoon/components/language/markup/xsp/XSPMarkupLanguage.html">
@@ -2152,7 +2150,7 @@
 encoding will be retrieved from an attribute named <tt>xsp:encoding</tt>
 present in the "user" root element.</div>
-<a name="N10611"></a><a name="Document+Preprocessing"></a>
+<a name="N1062D"></a><a name="Document+Preprocessing"></a>
 <h3 class="h4">Document Preprocessing</h3>
 <tt>XSPMarkupLanguage</tt> preprocesses its input document by:</p>
@@ -2184,7 +2182,7 @@
 be output by "reusing" their containing character arrays along with their
 corresponding offsets and lengths.</div>
-<a name="N1064D"></a><a name="Dependency+Tracking"></a>
+<a name="N1066A"></a><a name="Dependency+Tracking"></a>
 <h3 class="h4">Dependency Tracking</h3>
 <p>File dependencies passed to <tt>XSPMarkupLanguage</tt> by its
 <tt>AbstractMarkupLanguage</tt> superclass are stored in top-level
@@ -2192,7 +2190,7 @@
 <p>These elements are used by XSP code-generation logicsheets to populate the
 <tt>File</tt> array defined by the generated classes'
 <tt>AbstractServerPage</tt> superclass.</p>
-<a name="N10664"></a><a name="XSP+Builtin+Logicsheets"></a>
+<a name="N10682"></a><a name="XSP+Builtin+Logicsheets"></a>
 <h3 class="h4">XSP Builtin Logicsheets</h3>
 <p>XSP for Java currently provides only 2 builtin logicsheets: <tt>request</tt>
 and <tt>response</tt>, associated with their corresponding Cocoon counterparts.
@@ -2204,7 +2202,7 @@
 servlet objects is a must.</div>
-<a name="N10678"></a><a name="The+DOM-XSP+Markup+Language"></a>
+<a name="N10697"></a><a name="dom-xsp"></a>
 <h2 class="h3">The DOM-XSP Markup Language</h2>
 <div class="section">
 <p>The new, SAX-based XSP version for Cocoon is not backwards compatible with
@@ -2220,7 +2218,7 @@
 <p>For the long run, though, developers are strongly encouraged to replace their
 "legacy" DOM pages and classes with equivalent, faster SAX counterparts.</p>
-<a name="N1068C"></a><a name="The+Program+Generator"></a>
+<a name="N106AC"></a><a name="program-generator"></a>
 <h2 class="h3">The Program Generator</h2>
 <div class="section">
@@ -2250,7 +2248,7 @@
 <a href="apidocs/org/apache/cocoon/components/language/generator/ProgramGeneratorImpl.html">
 <tt>ProgramGeneratorImpl</tt>. </a>
-<a name="N106CE"></a><a name="Program+Repository"></a>
+<a name="N106EF"></a><a name="Program+Repository"></a>
 <h3 class="h4">Program Repository</h3>
 <tt>FilesystemStore</tt> is an implementation of the <tt>Store</tt>
@@ -2285,7 +2283,7 @@
 <li>All other <tt>Object</tt>'s are serialized</li>
-<a name="N10721"></a><a name="Program+Reloading"></a>
+<a name="N10743"></a><a name="Program+Reloading"></a>
 <h3 class="h4">Program Reloading</h3>
 <p>Unless the <tt>auto-reload</tt> sitemap option is in effect,
 <tt>ProgramGeneratorImpl</tt> will check whether program instances implement
@@ -2301,7 +2299,7 @@
 instances are used to generate and load a program for which an instance is
 created and then returned to the calling environment.</p>
-<a name="N10750"></a><a name="Named+Components"></a>
+<a name="N10773"></a><a name="named-components"></a>
 <h2 class="h3">Named Components</h2>
 <div class="section">
 <p>In order to support pluggable markup and programming languages, a new
@@ -2362,7 +2360,7 @@
-<a name="N107CB"></a><a name="XSP+Sitemap+Configuration"></a>
+<a name="N107EF"></a><a name="sitemap-configuration"></a>
 <h2 class="h3">XSP Sitemap Configuration</h2>
 <div class="section">
 <div class="frame note">

Modified: cocoon/site/site/2.1/userdocs/ziparchive-serializer.html
--- cocoon/site/site/2.1/userdocs/ziparchive-serializer.html (original)
+++ cocoon/site/site/2.1/userdocs/ziparchive-serializer.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
   |alternative credits
-<div id="credit2">
-<a href=""><img border="0" title="ApacheCon US 2005" alt="ApacheCon
US 2005 - logo" src="" style="width: 125px;height:
+<div id="credit2"></div>
     |end Menu

Modified: cocoon/site/site/2.1/who.html
--- cocoon/site/site/2.1/who.html (original)
+++ cocoon/site/site/2.1/who.html Tue Feb 14 22:36:05 2006
@@ -1203,9 +1203,7 @@
   |alternative credits
-<div id="credit2">
-<a href=""><img border="0" title="ApacheCon US 2005" alt="ApacheCon
US 2005 - logo" src="" style="width: 125px;height:
+<div id="credit2"></div>
     |end Menu

View raw message