package.html, [...]: Removed.
* gnu/java/net/protocol/ftp/package.html, gnu/javax/swing/text/html/package.html, gnu/javax/swing/text/html/parser/package.html, gnu/javax/swing/text/html/parser/models/package.html, gnu/javax/swing/text/html/parser/support/package.html, gnu/javax/swing/text/html/parser/support/low/package.html, gnu/xml/aelfred2/package.html, gnu/xml/dom/package.html, gnu/xml/pipeline/package.html, gnu/xml/transform/package.html, gnu/xml/util/package.html, java/awt/geom/doc-files/Area-1.png, java/awt/geom/doc-files/CubicCurve2D-1.png, java/awt/geom/doc-files/CubicCurve2D-2.png, java/awt/geom/doc-files/CubicCurve2D-3.png, java/awt/geom/doc-files/CubicCurve2D-4.png, java/awt/geom/doc-files/CubicCurve2D-5.png, java/awt/geom/doc-files/Ellipse-1.png, java/awt/geom/doc-files/FlatteningPathIterator-1.html, java/awt/geom/doc-files/GeneralPath-1.png, java/awt/geom/doc-files/QuadCurve2D-1.png, java/awt/geom/doc-files/QuadCurve2D-2.png, java/awt/geom/doc-files/QuadCurve2D-3.png, java/awt/geom/doc-files/QuadCurve2D-4.png, java/awt/geom/doc-files/QuadCurve2D-5.png, javax/imageio/package.html, javax/imageio/event/package.html, javax/imageio/metadata/package.html, javax/imageio/spi/package.html, javax/imageio/stream/package.html, javax/swing/border/doc-files/BevelBorder-1.png, javax/swing/border/doc-files/BevelBorder-2.png, javax/swing/border/doc-files/BevelBorder-3.png, javax/swing/border/doc-files/EmptyBorder-1.png, javax/swing/border/doc-files/EtchedBorder-1.png, javax/swing/border/doc-files/EtchedBorder-2.png, javax/swing/border/doc-files/LineBorder-1.png, javax/swing/border/doc-files/MatteBorder-1.png, javax/swing/border/doc-files/MatteBorder-2.png, javax/swing/border/doc-files/MatteBorder-3.png, javax/swing/border/doc-files/MatteBorder-4.png, javax/swing/border/doc-files/MatteBorder-5.png, javax/swing/border/doc-files/MatteBorder-6.png, javax/swing/border/doc-files/SoftBevelBorder-1.png, javax/swing/border/doc-files/SoftBevelBorder-2.png, javax/swing/border/doc-files/SoftBevelBorder-3.png, javax/swing/plaf/basic/doc-files/BasicBorders-1.png, javax/swing/plaf/basic/doc-files/BasicBorders-2.png, javax/swing/plaf/basic/doc-files/BasicBorders.ButtonBorder-1.png, javax/swing/plaf/basic/doc-files/BasicBorders.FieldBorder-1.png, javax/swing/plaf/basic/doc-files/BasicBorders.MarginBorder-1.png, javax/swing/plaf/basic/doc-files/BasicBorders.MenuBarBorder-1.png, javax/swing/plaf/basic/doc-files/BasicBorders.RadioButtonBorder-1.png, javax/swing/plaf/basic/doc-files/BasicBorders.SplitPaneBorder-1.png, javax/swing/plaf/basic/doc-files/BasicBorders.SplitPaneBorder-2.png, javax/swing/plaf/basic/doc-files/BasicBorders.SplitPaneDividerBorder-1.png, javax/swing/plaf/basic/doc-files/BasicBorders.ToggleButtonBorder-1.png, javax/swing/plaf/basic/doc-files/BasicGraphicsUtils-1.png, javax/swing/plaf/basic/doc-files/BasicGraphicsUtils-2.png, javax/swing/plaf/basic/doc-files/BasicGraphicsUtils-3.png, javax/swing/plaf/basic/doc-files/BasicGraphicsUtils-4.png, javax/swing/plaf/basic/doc-files/BasicGraphicsUtils-5.png, javax/swing/plaf/basic/doc-files/BasicGraphicsUtils-6.png, javax/swing/plaf/basic/doc-files/BasicGraphicsUtils-7.png, javax/swing/plaf/doc-files/ComponentUI-1.dia, javax/swing/plaf/doc-files/ComponentUI-1.png, javax/swing/plaf/doc-files/TreeUI-1.png, javax/xml/datatype/package.html, javax/xml/namespace/package.html, javax/xml/parsers/package.html, javax/xml/transform/package.html, javax/xml/transform/dom/package.html, javax/xml/transform/sax/package.html, javax/xml/transform/stream/package.html, javax/xml/validation/package.html, javax/xml/xpath/package.html: Removed. From-SVN: r102404
This commit is contained in:
@@ -1,77 +0,0 @@
|
||||
<html>
|
||||
<body>
|
||||
|
||||
<h1>GNU JAXP XSL transformer</h1>
|
||||
|
||||
<div>
|
||||
This package contains a Java XSL transformer compliant with the JAXP
|
||||
specification. It depends on the GNU DOM and XPath implementations, and
|
||||
will generate GNU DOM nodes unless a specific target from another
|
||||
implementation was given. It understands DOM, SAX, and stream sources
|
||||
and result sinks and supports these JAXP features.
|
||||
</div>
|
||||
|
||||
<div>
|
||||
To use this transformer, set the system property
|
||||
<code>javax.xml.transform.TransformerFactory</code> to the value
|
||||
<code>gnu.xml.transform.TransformerFactoryImpl</code>. You can then
|
||||
instantiate <a href='TransformerFactory.html'>TransformerFactory</a>
|
||||
and transformers in the ordinary manner. Reuse of stylesheets is
|
||||
supported using the JAXP <a href='Templates.html'>Templates</a>
|
||||
mechanism.
|
||||
</div>
|
||||
|
||||
<h3>Architecture</h3>
|
||||
|
||||
<div>
|
||||
When given a stylesheet source, this implementation compiles it internally
|
||||
into a Stylesheet object, which is a container for templates and state.
|
||||
Each stylesheet instruction is represented by a subclass of TemplateNode,
|
||||
which is arranged in a directed graph: each TemplateNode has a reference
|
||||
to its first child and the next node.
|
||||
</div>
|
||||
|
||||
<div>
|
||||
The transformation process consists of identifying the Template that matches
|
||||
the root of the source context, and calling <code>apply</code> on its
|
||||
corresponding TemplateNode. This in turn processes its children and next
|
||||
TemplateNode, depending on the semantics of each node type.
|
||||
</div>
|
||||
|
||||
<div>
|
||||
Template nodes may reference XPath expressions or patterns. These are fully
|
||||
compiled to objects of type <a href='../xpath/Expr.html'>Expr</a> at the
|
||||
time the stylesheet is compiled.
|
||||
</div>
|
||||
|
||||
<h3>Conformance</h3>
|
||||
|
||||
<div>
|
||||
This implementation is feature complete, but the XSLT specification is
|
||||
large and there are still many bugs that need to be ironed out. It has
|
||||
been tested against the OASIS XSLT TC test suite, comprising unit tests
|
||||
from the Xalan project and Microsoft. Conformance to these unit tests
|
||||
is approximately 70% at the current time, although normal usage of the
|
||||
transformer should involve relatively few surprises (the test suite is
|
||||
designed to test very complex and obscure functionality).
|
||||
</div>
|
||||
|
||||
<h3>Known bugs</h3>
|
||||
|
||||
<ul>
|
||||
<li>When reusing stylesheets using the JAXP Templates mechanism, XSL
|
||||
<code>apply-imports</code> instructions will not work.</li>
|
||||
<li>XPath filter expressions do not always work as expected (this is a
|
||||
problem with the GNU XPath implementation rather than the transformer).
|
||||
This can result in problems with the <code>position()</code> function,
|
||||
as well as <code>select</code> expressions and numbering.</li>
|
||||
</ul>
|
||||
|
||||
<div>
|
||||
Obviously we'd like to improve conformance and fix these bugs. If you're
|
||||
interested in working on any of these issues please
|
||||
<a href='mailto:classpathx-xml@gnu.org'>contact us</a>.
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user