You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by vm...@apache.org on 2003/05/01 21:20:37 UTC
cvs commit: xml-fop/src/documentation/content/xdocs/design index.xml properties.xml
vmote 2003/05/01 12:20:37
Modified: src/documentation/content/xdocs/design index.xml
properties.xml
Log:
Move glossary-type stuff from properties.xml to index.xml. Minor additions to overview in properties.xml.
Revision Changes Path
1.8 +33 -0 xml-fop/src/documentation/content/xdocs/design/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/design/index.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- index.xml 24 Apr 2003 14:53:56 -0000 1.7
+++ index.xml 1 May 2003 19:20:37 -0000 1.8
@@ -106,5 +106,38 @@
These resolution of these design issues is in support of the primary and secondary goals, so they are not necessarily written in stone.
However, most of them have been discussed at length among the developers, and are reasonably well settled.</p>
</section>
+
+
+ <section id="vocabulary">
+ <title>Vocabulary</title>
+ <p>This section will attempt to provide information about any jargon used in the design documentation.</p>
+ <p>There is a rough relationship between terms used to describe the various trees in XSL-FO processing, all of which come from the XML and XSL-FO standards. In the table below, the <em>terms</em> (but not the actual items) in each column are roughly equivalent to each other:</p>
+ <table>
+ <tr>
+ <th>Tree Concept</th>
+ <th>Thing (Noun)</th>
+ <th>Descriptive Item (Adjective)</th>
+ </tr>
+ <tr>
+ <td>XML</td>
+ <td>Element</td>
+ <td>Attribute</td>
+ </tr>
+ <tr>
+ <td>FO Tree</td>
+ <td>Object</td>
+ <td>Property</td>
+ </tr>
+ <tr>
+ <td>Area Tree</td>
+ <td>Area</td>
+ <td>Trait</td>
+ </tr>
+ </table>
+ <ul>
+ <li><strong>LM</strong>: Layout Manager.</li>
+ <li><strong>PLB</strong>: PropertyListBuilder.</li>
+ </ul>
+ </section>
</body>
</document>
1.11 +2 -30 xml-fop/src/documentation/content/xdocs/design/properties.xml
Index: properties.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/design/properties.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- properties.xml 29 Apr 2003 15:47:10 -0000 1.10
+++ properties.xml 1 May 2003 19:20:37 -0000 1.11
@@ -14,33 +14,6 @@
<p>As the input XSL-FO is being parsed and the FO Tree is being built, the attributes of the FO elements are passed by the parser to the related FO object.
The java object that represent the FO object then converts the attributes into properties that are stored in the FO Tree.</p>
</section>
- <section id="terms-related">
- <title>Related Terms</title>
- <p>It may be helpful here to show the rough relationship between terms used to describe the various trees in XSL-FO processing, all of which come from the XML and XSL-FO standards. In the table below, the <em>terms</em> (but not the actual items) in each column are roughly equivalent to each other:</p>
- <table>
- <tr>
- <th>Tree Concept</th>
- <th>Thing (Noun)</th>
- <th>Descriptive Item (Adjective)</th>
- </tr>
- <tr>
- <td>XML</td>
- <td>Element</td>
- <td>Attribute</td>
- </tr>
- <tr>
- <td>FO Tree</td>
- <td>Object</td>
- <td>Property</td>
- </tr>
- <tr>
- <td>Area Tree</td>
- <td>Area</td>
- <td>Trait</td>
- </tr>
- </table>
- </section>
-
<section id="issues">
<title>Issues</title>
<p>The following are some issues when dealing with properties:</p>
@@ -53,14 +26,13 @@
<li>Expressions: XSL-FO expressions can be included in properties.</li>
</ul>
</section>
-
<section id="process-overview">
<title>Overview of Processing</title>
<p>The general flow of property processing is as follows:</p>
<ul>
<li>As part of <code>FOTreeBuilder.startElement()</code>, <code>FObj.handleAttrs</code> is passed a list of attributes to be processed for the new FObj.</li>
- <li>FObj.handleAttrs gets a PropertyListBuilder and asks it to create a Property List from them. There is currently only one static PropertyListBuilder, which handles the fo: namespace.</li>
- <li>FObj.handleAttrs then cross-references the PropertyList with the FObj.</li>
+ <li>FObj.handleAttrs gets a PropertyListBuilder and asks it to create a Property List from the list of attributes. There is currently only one static PropertyListBuilder, which handles the fo: namespace.</li>
+ <li>FObj.handleAttrs then cross-references the returned PropertyList with the FObj, creates a PropertyManager to facilitate downstream processing of the PropertyList, and handles the special case of the writing-mode property.</li>
</ul>
</section>
<section id="plb">
---------------------------------------------------------------------
To unsubscribe, e-mail: fop-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: fop-cvs-help@xml.apache.org