From 8e37933ce17ec6a0558d59f3a65afca0ecf584c4 Mon Sep 17 00:00:00 2001
From: David Abram Cargill <cargilld@apache.org>
Date: Thu, 30 Sep 2004 00:55:09 +0000
Subject: [PATCH] Doc updates for 2.6
git-svn-id: https://svn.apache.org/repos/asf/xerces/c/trunk@176117 13f79535-47bb-0310-9956-ffa450edef68
---
credits.txt | 21 +++++++--
doc/faq-distrib.xml | 90 ++++----------------------------------
doc/feedback.xml | 34 +++++++++++++-
doc/migration.xml | 12 ++++-
doc/readme.xml | 69 ++---------------------------
doc/releases.xml | 12 +++--
doc/style/dtd/entities.ent | 25 +++++------
7 files changed, 92 insertions(+), 171 deletions(-)
diff --git a/credits.txt b/credits.txt
index 3e3e766dc..860f6b18f 100644
--- a/credits.txt
+++ b/credits.txt
@@ -16,28 +16,34 @@ James Berry
David Bertoni
John Bellardo
Arundhati Bhowmick
+Joanne Bogart
+Michael Boos
Edward Bortner
Sean Bright
Phil Brown
Robert Buck
+David Cargill
Sumit Chawla
Nick Chiang
Chih Hsiang Chou
Radovan Chytracek
Hiram Clawson
John Clayton
-Nathan Codding
Todd Collins
+Nathan Codding
Michael Crawford
Murray Cumming
Zeid Derhally
James Devries
Ailian Ding
+Steve Dulin
Helmut Eiken
Mark Everline
+Andrew Fang
Simon Fell
Paul Ferguson
Pierpaolo Fumagalli
+Syam Gadde
Guido Gagliardi
Gary Gale
Michael Glavassevich
@@ -48,9 +54,12 @@ Neil Graham
Susan Hardenbrook
Jeff Harrell
Andrew Hefford
+Adam Heinz
Andy Heninger
+John Hibbert
William L. Hopper
Michael Huedepohl
+Anders Hybertz
Rahul Jain
Tom Jordahl
Christopher Just
@@ -65,18 +74,22 @@ Berin Lautenbach
Arnaud LeHors
Andy Levine
Jeff Lewis
+James Littlejohn
+Ray Logel
Pedro Lopes
Matt Lovett
Sean MacRoibeaird
Alberto Massari
Don Mastrovito
David McCreedy
+Shin'ya MORINO
Urs Muff
Jordan Naftolin
Tinny Ng
David Nickerson
Khaled Noaman
Michael Ottati
+Anthony O'Dowd
Kevin Philips
Mike Pogue
Joe Polastre
@@ -87,6 +100,7 @@ Jim Reitz
Caroline Rioux
Dean Roddey
John Roper
+Dan Rosen
Steven Rosenthal
Erik Rydgren
Bill Schindler
@@ -94,16 +108,17 @@ Erik Schroeder
Christian Schuhegger
John Smirl
Andrei Smirnov
+John Snelson
Gereon Steffens
Jason Stewart
Rick J. Stevens
Roman Sulzhyk
-Vasily Tchekalkin
Linda M. Swan
+Vasily Tchekalkin
Pieter Van-Dyck
Curtis Walker
-Tom Watson
John Warrier
+Tom Watson
Mark Weaver
Roger Webster
Robert Weir
diff --git a/doc/faq-distrib.xml b/doc/faq-distrib.xml
index baf69a5cc..256058f58 100644
--- a/doc/faq-distrib.xml
+++ b/doc/faq-distrib.xml
@@ -28,65 +28,8 @@
<p>&XercesCProjectName; binaries has been built on the following platforms with
these compilers</p>
- <table>
- <tr>
- <th><em>Operating System</em></th>
- <th><em>Compiler</em></th>
- </tr>
- <tr>
- <th><em>32-bit binary</em></th>
- <td></td>
- </tr>
- <tr>
- <td>Windows NT 4.0 SP5</td>
- <td>MSVC 6.0 SP3</td>
- </tr>
- <tr>
- <td>Redhat Linux 7.2</td>
- <td>Intel C++ Compiler v6, icc</td>
- </tr>
- <tr>
- <td>AIX 5.1</td>
- <td>xlC_r 5.0.2</td>
- </tr>
- <tr>
- <td>Solaris 2.7</td>
- <td>Forte C++ Version 6 Update 2</td>
- </tr>
- <tr>
- <td>HP-UX 11.0</td>
- <td>aCC A.03.13 with pthreads</td>
- </tr>
- <tr>
- <td>SuSE Linux 7.2 (S390)</td>
- <td>g++ 2.95</td>
- </tr>
- <tr>
- <th><em>64-bit binary</em></th>
- <td></td>
- </tr>
- <tr>
- <td>Windows XP, IA64</td>
- <td>Intel C++ Compiler v7, ecl</td>
- </tr>
- <tr>
- <td>Redhat Linux 7.2, IA64</td>
- <td>Intel C++ Compiler v6, ecc</td>
- </tr>
- <tr>
- <td>AIX 5.1</td>
- <td>xlC_r 5.0.2</td>
- </tr>
- <tr>
- <td>Solaris 2.7</td>
- <td>Forte C++ Version 6 Update 2</td>
- </tr>
- <tr>
- <td>HP-UX 11.0</td>
- <td>aCC A.03.13 with pthreads</td>
- </tr>
- </table>
-
+ &build-winunix-supported-platforms;
+
</a>
</faq>
@@ -112,17 +55,10 @@
<p>ICU is also an open source project but is licensed
under the <jump
href="http://www.x.org/terms.htm">
- X License</jump>. XML4C is published by IBM and
- can be downloaded from their <jump
+ X License</jump>.
+ Information about XML4C is available at <jump
href="http://www.alphaworks.ibm.com/tech/xml4c">Alphaworks</jump>
- site. The license to use XML4C is simply to comply with
- the Apache license (because of Xerces-C) and X License (because of ICU).</p>
-
- <p>XML4C binaries are published for the same set of platforms / compilers
- as Xerces-C++, see <jump href="faq-distrib.html#faq-1">FAQ:
- What platforms / compilers are being used to build the binary distribution kits?</jump>
- and the documentation in
- <jump href="http://www.alphaworks.ibm.com/tech/xml4c">Alphaworks</jump>.</p>
+ site.</p>
</a>
</faq>
@@ -130,25 +66,15 @@
<faq title="Which DLL's do I need to distribute with my application?">
<q>Which DLL's do I need to distribute with my application?</q>
<a>
- <p>As mentioned above, there are two configurations in
- which Xerces-C binaries are shipped. One is from the <jump
- href="http://xml.apache.org/xerces-c/index.html">Apache
- site</jump>, while the other is from IBM
- published at <jump
- href="http://www.alphaworks.ibm.com/tech/xml4c">IBM's
- Alphaworks Site</jump>.</p>
-
- <p>If you are using the binaries from the <jump
- href="http://xml.apache.org/dist/xerces-c/">Apache download
- site</jump> site, then you only need to distribute
- <em>one</em> file:<br></br>
+
+ <p>You only need to distribute <em>one</em> file:<br></br>
&XercesCWindowsDLL;.dll for Windows NT/2000, or<br/>
&XercesCUnixLib;&XercesCUnixSoName;.so for AIX, or<br/>
&XercesCUnixLib;.so.&XercesCUnixSoName; for Solaris/Linux, or<br/>
&XercesCUnixLib;.sl.&XercesCUnixSoName; for HP-UX.</p>
- <p>However, if you are using the XML4C binaries then in
+ <p>However, if you are using the ICU transcoder then in
<em>addition</em> to the library file
mentioned above, you also need to ship:</p>
diff --git a/doc/feedback.xml b/doc/feedback.xml
index feb140348..9d4df8cdf 100644
--- a/doc/feedback.xml
+++ b/doc/feedback.xml
@@ -34,7 +34,7 @@
<p>Listed below are some names (in alphabetical order) of people to whom
we would like to give special thanks. </p>
-
+
<ul>
<li>Nadav Aharoni</li>
<li>Curt Arnold</li>
@@ -49,10 +49,13 @@
<li>David Bertoni</li>
<li>John Bellardo</li>
<li>Arundhati Bhowmick</li>
+ <li>Joanne Bogart</li>
+ <li>Michael Boos</li>
<li>Edward Bortner</li>
<li>Sean Bright</li>
<li>Phil Brown</li>
<li>Robert Buck</li>
+ <li>David Cargill</li>
<li>Sumit Chawla</li>
<li>Nick Chiang</li>
<li>Chih Hsiang Chou</li>
@@ -60,21 +63,36 @@
<li>Hiram Clawson</li>
<li>John Clayton</li>
<li>Todd Collins</li>
+ <li>Nathan Coddin</li>
<li>Michael Crawford</li>
<li>Murray Cumming</li>
+ <li>Zeid Derhally</li>
+ <li>James Devries</li>
+ <li>Ailian Ding</li>
+ <li>Steve Dulin</li>
<li>Helmut Eiken</li>
<li>Mark Everline</li>
+ <li>Andrew Fang</li>
<li>Simon Fell</li>
<li>Paul Ferguson</li>
<li>Pierpaolo Fumagalli</li>
+ <li>Syam Gadde</li>
+ <li>Guido Gagliardi</li>
<li>Gary Gale</li>
+ <li>Michael Glavassevich</li>
+ <li>Natalie Gorden</li>
<li>Max Gotlib</li>
<li>Petr Gotthard</li>
+ <li>Neil Graham</li>
<li>Susan Hardenbrook</li>
<li>Jeff Harrell</li>
+ <li>Andrew Hefford</li>
+ <li>Adam Heinz</li>
<li>Andy Heninger</li>
+ <li>John Hibbert</li>
<li>William L. Hopper</li>
<li>Michael Huedepohl</li>
+ <li>Anders Hybertz</li>
<li>Rahul Jain</li>
<li>Tom Jordahl</li>
<li>Christopher Just</li>
@@ -85,19 +103,26 @@
<li>Richard Ko</li>
<li>Paul Kramer</li>
<li>Volker Krause</li>
+ <li>Berin Lautenbach</li>
<li>Arnaud LeHors</li>
- <li>Andy Levine</li>
+ <li>Andy Levine</li>
<li>Jeff Lewis</li>
+ <li>James Littlejohn</li>
+ <li>Ray Logel</li>
+ <li>Pedro Lopes</li>
<li>Matt Lovett</li>
<li>Sean MacRoibeaird</li>
<li>Alberto Massari</li>
<li>Don Mastrovito</li>
<li>David McCreedy</li>
+ <li>Shin'ya MORINO</li>
+ <li>Urs Muff</li>
<li>Jordan Naftolin</li>
<li>Tinny Ng</li>
<li>David Nickerson</li>
<li>Khaled Noaman</li>
<li>Michael Ottati</li>
+ <li>Anthony O'Dowd</li>
<li>Kevin Philips</li>
<li>Mike Pogue</li>
<li>Joe Polastre</li>
@@ -105,8 +130,10 @@
<li>Shengkai Qu</li>
<li>Gareth Reakes</li>
<li>Jim Reitz</li>
+ <li>Caroline Rioux</li>
<li>Dean Roddey</li>
<li>John Roper</li>
+ <li>Dan Rosen</li>
<li>Steven Rosenthal</li>
<li>Erik Rydgren</li>
<li>Bill Schindler</li>
@@ -114,11 +141,13 @@
<li>Christian Schuhegger</li>
<li>John Smirl</li>
<li>Andrei Smirnov</li>
+ <li>John Snelson</li>
<li>Gereon Steffens</li>
<li>Jason Stewart</li>
<li>Rick J. Stevens</li>
<li>Roman Sulzhyk</li>
<li>Linda M. Swan</li>
+ <li>Vasily Tchekalkin</li>
<li>Pieter Van-Dyck</li>
<li>Curtis Walker</li>
<li>John Warrier</li>
@@ -132,6 +161,7 @@
<li>Kirk Wylie</li>
<li>Peter A. Volchek</li>
<li>Grace Yan</li>
+ <li>Hiramatsu Yoshifumi</li>
<li>PeiYong Zhang</li>
<li>Henry Zongaro</li>
</ul>
diff --git a/doc/migration.xml b/doc/migration.xml
index dce2ccb3f..ee4572e16 100644
--- a/doc/migration.xml
+++ b/doc/migration.xml
@@ -39,8 +39,11 @@
<li><link anchor="DeprecatedAPI260">Deprecated/Removed Public API</link></li>
<li>Please note the following source code incompatibility: Rename VALUE_CONSTRAINT enumeration values in XSConstants.hpp due to conflict with system header. New
values are VALUE_CONSTRAINT_NONE, VALUE_CONSTRAINT_DEFAULT and VALUE_CONSTRAINT_FIXED. Old
- values are VC_NONE, VC_DEFAULT and VC_FIXED.
- </li>
+ values are VC_NONE, VC_DEFAULT and VC_FIXED.</li>
+ <li>Also note that if you have implemented your own XMLGrammarPool implementation, that
+ the original getXSModel has been marked deprecated and a new method, of the same
+ name, that takes a bool parameter has been added. This new getXSModel needs
+ to always return an XSModel.</li>
</ul>
</ul>
@@ -80,6 +83,7 @@
<ul>
<li>XSValue</li>
<li>IdentityConstraintHandler</li>
+ <li>XMLBufferFullHandler</li>
<li>XMLString: removeChar, isValidNOTATION</li>
<li>XMLUri: normalizeUri</li>
<li>PSVIHandler: handlePartialElementPSVI</li>
@@ -95,6 +99,7 @@
<li>PSVIItem: getActualValue</li>
<li>XSSimpleTypeDefinition: getDatatypeValidator</li>
<li>RefHash2KeysTableOf: transferElement</li>
+ <li>XMLGrammarPool: getXSModel</li>
</ul>
</s4>
@@ -115,6 +120,9 @@
<li>SchemaAttDef: setAnyDatatypeValidator</li>
<li>UnionDatatypeValidator: getMemberTypeName, getMemberTypeUri, getMemberTypeAnonymous, getMemberTypeValidator</li>
<li>XMLAttr: getValidatingTypeURI, getValidatingTypeName, setDatatypeValidator, setSchemaValidated</li>
+ <li>ComplexTypeInfo: setContentModel</li>
+ <li>XMLGrammarPool: getXSModel</li>
+ <li>SAXParser, mark this class deprecated</li>
</ul>
</s4>
diff --git a/doc/readme.xml b/doc/readme.xml
index 6d17f0404..41bd5af86 100644
--- a/doc/readme.xml
+++ b/doc/readme.xml
@@ -96,69 +96,8 @@
</s2>
<s2 title="Platforms with Binaries">
- <table>
- <tr>
- <th><em>Operating System</em></th>
- <th><em>Compiler</em></th>
- </tr>
- <tr>
- <th><em>32-bit binary</em></th>
- <td></td>
- </tr>
- <tr>
- <td>Windows NT 4.0 SP5</td>
- <td>MSVC 6.0 SP3</td>
- </tr>
- <tr>
- <td>Redhat Linux 7.2</td>
- <td>Intel C++ Compiler v7, icc</td>
- </tr>
- <tr>
- <td>Redhat Linux 8.0</td>
- <td>gcc Compiler v3.2</td>
- </tr>
- <tr>
- <td>AIX 5.1</td>
- <td>xlC_r 6.0.0</td>
- </tr>
- <tr>
- <td>Solaris 2.7</td>
- <td>Forte C++ Version 6 Update 2</td>
- </tr>
- <tr>
- <td>HP-UX 11.0</td>
- <td>aCC A.03.13 with pthreads</td>
- </tr>
- <tr>
- <td>SuSE Linux 7.2 (S390)</td>
- <td>g++ 2.95.3</td>
- </tr>
- <tr>
- <th><em>64-bit binary</em></th>
- <td></td>
- </tr>
- <tr>
- <td>Windows XP, IA64</td>
- <td>Intel C++ Compiler v7, ecl</td>
- </tr>
- <tr>
- <td>Redhat Linux 7.2, IA64</td>
- <td>Intel C++ Compiler v7, ecc</td>
- </tr>
- <tr>
- <td>AIX 5.1</td>
- <td>xlC_r 6.0.0</td>
- </tr>
- <tr>
- <td>Solaris 2.7</td>
- <td>Forte C++ Version 6 Update 2</td>
- </tr>
- <tr>
- <td>HP-UX 11.0</td>
- <td>aCC A.03.13 with pthreads</td>
- </tr>
- </table>
- </s2>
+ &build-winunix-supported-platforms;
+ </s2>
<s2 title="Other ports...">
<ul>
@@ -176,8 +115,8 @@
<s2 title='License Information'>
<p>The &XercesCName; Version &XercesCVersion; is available in both source distribution and
- binary distribution. Both &XercesCName; are made available under the
- <jump href='http://xml.apache.org/LICENSE'>Apache Software License</jump>.
+ binary distribution. &XercesCName; is made available under the
+ <jump href='http://www.apache.org/licenses/LICENSE-2.0.html'>Apache Software License, Version 2.0</jump>.
</p>
</s2>
diff --git a/doc/releases.xml b/doc/releases.xml
index 4f807b32a..c90ee384d 100644
--- a/doc/releases.xml
+++ b/doc/releases.xml
@@ -39,13 +39,19 @@
<th>Contributor</th>
<th>Description</th>
</tr>
+
+
+<tr><td>2004-09-29</td><td>Khaled Noaman </td><td>Bug 1209 </td></tr>
+<tr><td>2004-09-29</td><td>David Cargill </td><td>Mark SAXParser as deprecated. </td></tr>
+<tr><td>2004-09-29</td><td>David Cargill </td><td>jira1217 </td></tr>
+<tr><td>2004-09-29</td><td>Dan Rosen </td><td> jira1207 </td></tr>
<tr><td>2004-09-28</td><td>Khaled Noaman, Anthony O'Dowd </td><td> Performance: improve src offset calculation. </td></tr>
<tr><td>2004-09-28</td><td>PeiYong Zhang </td><td> Optimized duplicated attributes checking for large number of attributes</td></tr>
<tr><td>2004-09-28</td><td>Alberto Massari </td><td>BCC 511 updates </td></tr>
<tr><td>2004-09-27</td><td>David Cargill </td><td>Update sample to use an error handler and only generate xsmodel when a schema document has been loaded successfully. </td></tr>
<tr><td>2004-09-27</td><td>David Cargill </td><td> Update documentation to describe new features </td></tr>
-<tr><td>2004-09-27</td><td>Khaled, David Cargill </td><td>Validate annotations </td></tr>
-<tr><td>2004-09-27</td><td> Khaled Noaman</td><td> Reset datatype validator </td></tr>
+<tr><td>2004-09-27</td><td>Khaled Noaman, David Cargill </td><td>Validate annotations </td></tr>
+<tr><td>2004-09-27</td><td>Khaled Noaman</td><td> Reset datatype validator </td></tr>
<tr><td>2004-09-27</td><td>David Cargill </td><td>XERCESC-1277 </td></tr>
<tr><td>2004-09-26</td><td>Khaled Noaman </td><td>[Bug 1197] </td></tr>
<tr><td>2004-09-25</td><td>Gareth Reakes, Adam Heinz </td><td> Fix to 1264. All refererences to public headers now use the include files.</td></tr>
@@ -59,7 +65,7 @@
<tr><td>2004-09-21</td><td>PeiYong Zhang </td><td>Do not build/ship debug version lib on Windows </td></tr>
<tr><td>2004-09-21</td><td>PeiYong Zhang </td><td>Change lib name on Windows from 2_5_0 to 2_5 </td></tr>
<tr><td>2004-09-21</td><td>David Cargill </td><td> Documentation Updates. </td></tr>
-<tr><td>2004-09-21</td><td> PeiYong Zhang</td><td> Handle partial PSVIElement</td></tr>
+<tr><td>2004-09-21</td><td>PeiYong Zhang</td><td> Handle partial PSVIElement</td></tr>
<tr><td>2004-09-20</td><td>James Berry </td><td>Mac updates </td></tr>
<tr><td>2004-09-20</td><td>Alberto Massari </td><td>Added a setCreateSchemaInfo method to the DOM parsers, to store PSVI informations in element and attribute nodes </td></tr>
<tr><td>2004-09-20</td><td>Alberto Massari </td><td> Mark some methods as deprecated </td></tr>
diff --git a/doc/style/dtd/entities.ent b/doc/style/dtd/entities.ent
index 83d62704a..4940da049 100644
--- a/doc/style/dtd/entities.ent
+++ b/doc/style/dtd/entities.ent
@@ -112,21 +112,22 @@ purpose of your reporting of the bug.
</s2>
'>
-<!-- build-winunix.xml supported platforms -->
+<!-- build-winunix.xml & faq-distrib.xml supported platforms -->
<!ENTITY build-winunix-supported-platforms '
<table>
<tr><th><em>Operating System</em></th><th><em>Compiler</em></th></tr>
<tr><th><em>32-bit binary</em></th><td></td></tr>
-<tr><td>Redhat Linux 7.2</td><td>Intel C++ Compiler v6, icc</td></tr>
-<tr><td>AIX 5.1</td><td>xlC_r 5.0.2</td></tr>
-<tr><td>Solaris 2.7</td><td>Forte C++ Version 6 Update 2</td></tr>
-<tr><td>HP-UX 11.0</td><td>aCC A.03.13 with pthreads</td></tr>
-<tr><td>SuSE Linux 7.2 (S390)</td><td>g++ 2.95</td></tr>
+<tr><td>Windows NT</td><td>MS Visual C++ 6.0 SP3</td></tr>
+<tr><td>AIX 5.1</td><td>xlC_r 6.0.0</td></tr>
+<tr><td>Solaris 2.8</td><td>Forte C++ Version 6 Update 2</td></tr>
+<tr><td>HP-UX 11i</td><td>aCC A.03.52 with pthreads</td></tr>
+<tr><td>Redhat Linux 8.0 (IA32)</td><td>gcc 3.2</td></tr>
+
<tr><th><em>64-bit binary</em></th><td></td></tr>
-<tr><td>Redhat Linux 7.2, IA64</td><td>Intel C++ Compiler v6, ecc</td></tr>
-<tr><td>AIX 5.1</td><td>xlC_r 5.0.2</td></tr>
-<tr><td>Solaris 2.7</td><td>Forte C++ Version 6 Update 2</td></tr>
-<tr><td>HP-UX 11.0</td><td>aCC A.03.13 with pthreads</td></tr>
+<tr><td>AIX 5.1</td><td>xlC_r 6.0.0</td></tr>
+<tr><td>Solaris 2.8</td><td>Forte C++ Version 6 Update 2</td></tr>
+<tr><td>HP-UX 11i</td><td>aCC A.03.52 with pthreads</td></tr>
+<tr><td>SuSE Linux 8.0 (AMD64)</td><td>gcc 3.2.2</td></tr>
</table>
'>
@@ -207,10 +208,6 @@ please refer to <jump href="releases_plan.html">Releases Plan</jump>.
<!-- paragraph in releases.xml with table of bugzilla bugs fixed -->
<!ENTITY releases-fixed-bugs-para '
-<p>Here is the list of <jump href=
-"http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfield=resolution&chfieldfrom=02&percent;2F07&percent;2F03&chfieldto=05&percent;2F23&percent;2F03&chfieldvalue=fixed&product=Xerces-C&percent;2B&percent;2B&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&newqueryname=&order=bugs.bug_id">
-fixed bugzilla bugs</jump> that are resolved in this release, &XercesCName; &XercesCVersion;.
-</p>
'>
<!-- feedback info in schema.xml -->
--
GitLab