← Back to branch summary

~ubuntu-branches/ubuntu/karmic/libxerces2-java/karmic

« back to all changes in this revision

Viewing changes to docs/dom3.xml

  • Committer: Bazaar Package Importer
  • Author(s): Stefan Gybas
  • Date: 2004-06-06 18:00:26 UTC
  • Revision ID: james.westby@ubuntu.com-20040606180026-a3vh56uc95hjbyfh
Tags: upstream-2.6.2
Import upstream version 2.6.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/dom3.xml
 
1
<?xml version="1.0" standalone="no"?>
 
2
<!DOCTYPE s1 SYSTEM "./dtd/document.dtd">
 
3
<s1 title="Document Object Model Level 3 Implementation">
 
4
        <s2 title="Disclaimer">
 
5
                <p>
 
6
 
 
7
                        The &ParserNameLong; &ParserVersion; contains a partial
 
8
                        implementation of the W3C Document Object Model Level 3.
 
9
                </p>
 
10
                <p>
 
11
                        The
 
12
                        <jump href="http://www.w3.org/DOM/DOMTR#DOML3">DOM Level 3</jump>
 
13
                        specification is at the stage of
 
14
                        <strong>Proposed Recommendation</strong>, which represents work in progress 
 
15
                        and has been widely reviewed and satisfies certain technical requirements
 
16
                        but may still change based on implementation experience.
 
17
 
 
18
                        This implementation is experimental: it should not be
 
19
                        considered as complete or correct.
 
20
                </p>
 
21
        </s2>
 
22
        <s2 title="Introduction">
 
23
                <p>
 
24
                        The &ParserNameLong; &ParserVersion; contains an implementation of 
 
25
                        the Document Object Model Level 3 <jump href="http://www.w3.org/TR/2004/PR-DOM-Level-3-Core-20040205/">Core</jump> 
 
26
                        and Document Object Model Level 3 <jump href="http://www.w3.org/TR/2004/PR-DOM-Level-3-LS-20040205/">Load and Save</jump> Proposed Recommendations.
 
27
                        To learn how to program with the DOM Level 3 see <jump href="samples-dom.html#DOM3">dom.DOM3</jump> sample.
 
28
                </p>
 
29
 
 
30
 
 
31
                <note>
 
32
                        To find out how to access
 
33
                        <em>DOM Level 3 functionality</em>, please refer to the
 
34
                        <link idref='faq-dom'>FAQ</link>
 
35
                        .
 
36
                </note>
 
37
        </s2>
 
38
 
 
39
        <s2 title='Implementation of DOM Level 3 Core'>
 
40
                <p>
 
41
                        The <code>parameters</code> supported are:
 
42
                </p>
 
43
                <ul>
 
44
                        <li>
 
45
                                <strong>error-handler</strong>
 
46
                                [
 
47
                                <em>DOMErrorHandler</em>
 
48
                                ]
 
49
                        </li>
 
50
                        <li>
 
51
                                <strong>resource-resolver</strong>
 
52
                                [
 
53
                                <em>DOMResourceResolver</em>
 
54
                                ]
 
55
                        </li>
 
56
                        <li>
 
57
                                <strong>schema-type</strong>
 
58
                                [
 
59
                                <em>String</em>
 
60
                                ]
 
61
                        </li>
 
62
                        <li>
 
63
                                <strong>schema-location</strong>
 
64
                                [
 
65
                                <em>String</em>
 
66
                                ]
 
67
                        </li>
 
68
                        <li>
 
69
                                <strong>canonical-form</strong>
 
70
                                [
 
71
                                <em>false</em>
 
72
                                ]
 
73
                        </li>
 
74
                        <li>
 
75
                                <strong>cdata-sections</strong>
 
76
                                [
 
77
                                <em>true/false</em>
 
78
                                ]
 
79
                        </li>
 
80
                        <li>
 
81
                                <strong>comments</strong>
 
82
                                [
 
83
                                <em>true/false</em>
 
84
                                ]
 
85
                        </li>
 
86
                        <li>
 
87
                                <strong>namespaces</strong>
 
88
                                [
 
89
                                <em>true/false</em>
 
90
                                ]
 
91
                        </li>
 
92
                        <li>
 
93
                                <strong>entities</strong>
 
94
                                [
 
95
                                <em>true/false</em>
 
96
                                ]
 
97
                        </li>
 
98
                        <li>
 
99
                                <strong>infoset</strong>
 
100
                                [
 
101
                                <em>true/false</em>
 
102
                                ]
 
103
                        </li>
 
104
                        <li>
 
105
                                <strong>namespace-declarations</strong>
 
106
                                [
 
107
                                <em>true</em>
 
108
                                ]
 
109
                        </li>
 
110
                        <li>
 
111
                                <strong>normalize-characters</strong>
 
112
                                [
 
113
                                <em>false</em>
 
114
                                ]
 
115
                        </li>
 
116
                        <li>
 
117
                                <strong>split-cdata-sections</strong>
 
118
                                [
 
119
                                <em>true/false</em>
 
120
                                ]
 
121
                        </li>
 
122
                        <li>
 
123
                                <strong>validate-if-schema</strong>
 
124
                                [
 
125
                                <em>true/false</em>
 
126
                                ]
 
127
                        </li>
 
128
                        <li>
 
129
                                <strong>element-content-whitespace</strong>
 
130
                                [
 
131
                                <em>true</em>
 
132
                                ]
 
133
                        </li>
 
134
                        <li>
 
135
                                <strong>datatype-normalization</strong>
 
136
                                [
 
137
                                <em>true/false</em>
 
138
                                ]
 
139
                        </li>
 
140
                        <li>
 
141
                                <strong>validate</strong>
 
142
                                [
 
143
                                <em>true/false</em>
 
144
                                ] -- revalidation is supported only against XML Schemas. For more information, please refer to
 
145
                                <link idref='faq-dom'>How to revalidate DOM in memory?</link>
 
146
                                .
 
147
                        </li>
 
148
                        <li>
 
149
                                <strong>validate-if-schema</strong>
 
150
                                [
 
151
                                <em>true/false</em>
 
152
                                ]
 
153
                        </li>
 
154
                        <li>
 
155
                                <strong>check-character-normalization</strong>
 
156
                                [
 
157
                                <em>false</em>
 
158
                                ]
 
159
                        </li>                   
 
160
                        <li>
 
161
                                <strong>well-formed</strong>
 
162
                                [
 
163
                                <em>true/false</em>
 
164
                                ]
 
165
                        </li>   
 
166
                        <li>
 
167
                                <strong>psvi</strong>
 
168
                                [
 
169
                                <em>true/false</em>
 
170
                                ] -- (NON-DOM) setting the value of this parameter to true will include 
 
171
                                PSVI information in the DOM tree. 
 
172
                        </li>
 
173
 
 
174
                </ul>
 
175
        </s2>
 
176
 
 
177
        <s2 title='Implementation of DOM Level 3 Load and Save'>
 
178
                <p>Most of the functionality is implemented. Here is the list of limitations:</p>
 
179
                <ul>
 
180
 
 
181
                <li>
 
182
                        <strong>LSParser</strong> <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/load-save.html#LS-LSParser-parseWithContext">
 
183
                        parserWithContext</jump>
 
184
                         -- not supported.
 
185
                </li>
 
186
              <li><strong>DOMImplementationLS</strong> <jump href="http://www.w3.org/TR/2003/CR-DOM-Level-3-LS-20031107/load-save.html#LS-DOMIMplementationLS-MODE_ASYNCH">
 
187
                        MODE_ASYNCHRONOUS</jump> 
 
188
                                -- not supported.
 
189
                        </li>
 
190
            <li><strong>LSSerializer</strong> - the following parameters are not supported:</li>
 
191
<ul>
 
192
<li><strong>normalize-characters</strong>
 
193
[
 
194
<em>true</em>
 
195
]</li>
 
196
</ul>
 
197
</ul>
 
198
 
 
199
        </s2>
 
200
 
 
201
</s1>
 
 
b'\\ No newline at end of file'