You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@santuario.apache.org by ge...@apache.org on 2002/09/09 14:08:42 UTC

cvs commit: xml-security/doc/xml/sources api.xml docs-book.xml faq-common.xml faq.xml history.xml install.xml interop.xml readme.xml resolvermania.xml resources.xml

geuerp      2002/09/09 05:08:42

  Modified:    doc/xml/dtd entities.ent
               doc/xml/sources api.xml docs-book.xml faq-common.xml faq.xml
                        history.xml install.xml interop.xml readme.xml
                        resolvermania.xml resources.xml
  Log:
  Changed DTD to stylebook style
  
  Revision  Changes    Path
  1.4       +4 -4      xml-security/doc/xml/dtd/entities.ent
  
  Index: entities.ent
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/dtd/entities.ent,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- entities.ent	6 Sep 2002 09:03:45 -0000	1.3
  +++ entities.ent	9 Sep 2002 12:08:41 -0000	1.4
  @@ -6,7 +6,7 @@
   <!ENTITY packagedirectory "@@packagedirectory@@">
   <!ENTITY packagedistname  "@@packagedistname@@">
   
  -<!ENTITY xmlsec           "Apache-XML-Security-J">
  -<!ENTITY xmldsig          "W3C XML-Signature Syntax and Processing">
  -<!ENTITY xmlenc           "W3C XML Encryption Syntax and Processing">
  -<!ENTITY hac              "Handbook of Applied Cryptography">
  +<!ENTITY xmlsec  "Apache-XML-Security-J">
  +<!ENTITY xmldsig "W3C XML-Signature Syntax and Processing">
  +<!ENTITY xmlenc  "W3C XML Encryption Syntax and Processing">
  +<!ENTITY hac     "Handbook of Applied Cryptography">
  
  
  
  1.2       +11 -14    xml-security/doc/xml/sources/api.xml
  
  Index: api.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/api.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- api.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ api.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,19 +1,16 @@
   <?xml version="1.0" standalone="no"?>
  -<!DOCTYPE s1 SYSTEM "../style/dtd/document.dtd">
  +<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
   
   <s1 title="API Documentation">
  -    <s2 title="Javadoc Generated Documentation">
  -        <p>&packagenamelong; comes packaged with API documentation.</p>
  -        <p>This documentation is generated automatically from the Javadoc-style 
  -        comments inside the source files.  Click on one of the links below to 
  -        go to the appropriate API documentation.</p>
  -    </s2>
  -    <s2 title="&packagename; API Documentation">
  -        <ul>
  -            <li><jump href="api/index.html">Full API documentation</jump></li>
  -            <li><jump href="api/overview-tree.html">Hierarchy for all the packages</jump></li>
  -            <li>If the above documentation is outdated, an always-fresh copy can be found 
  -            <jump href="http://nagoya.apache.org/gump/javadoc/xml-security/build/doc/html/api/index.html">here</jump></li>
  -        </ul>
  +  <s2 title="Javadoc Generated Documentation">
  +    <p>&packagenamelong; comes packaged with API documentation.</p>
  +    <p>This documentation is generated automatically from the Javadoc-style comments inside the source files.  Click on one of the links below to go to the appropriate API documentation.</p>
  +  </s2>
  +  <s2 title="&packagename; API Documentation">
  +    <ul>
  +      <li><jump href="api/index.html">Full API documentation</jump></li>
  +      <li><jump href="api/overview-tree.html">Hierarchy for all the packages</jump></li>
  +      <li>If the above documentation is outdated, an always-fresh copy can be found <jump href="http://nagoya.apache.org/gump/javadoc/xml-security/build/doc/html/api/index.html">here</jump></li>
  +    </ul>
     </s2>
   </s1>
  
  
  
  1.2       +13 -9     xml-security/doc/xml/sources/docs-book.xml
  
  Index: docs-book.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/docs-book.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- docs-book.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ docs-book.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,5 +1,6 @@
   <?xml version="1.0"?>
  -<!DOCTYPE book SYSTEM "../style/dtd/book.dtd">
  +<!DOCTYPE book SYSTEM "sbk:/style/dtd/book.dtd">
  +
   <book title="XML-Security Documentation" 
         copyright="2001 The Apache Software Foundation">
     <resources source="sbk:/sources/resources.xml"/>
  @@ -9,11 +10,22 @@
     <document label="Readme"       
               id="index"
               source="readme.xml" />
  +
  +
     <faqs     label='FAQs'
               title='Frequently Asked Questions' 
               id='faqs'
               source='faq.xml'>
     </faqs>
  +  <!-- 
  +  <group    label="FAQs"
  +            id="faqs"
  +            title="Frequently Asked Questions">
  +    <entry  id="faq-resolvers"
  +            source="faq-resolvers.xml" />
  +  </group>
  +  -->
  +
     <external label="Download"
               href="http://xml.apache.org/security/dist/" />
     <external label="Repository"
  @@ -27,14 +39,6 @@
     <document label="Interoperability" 
               id="interop"     
               source="interop.xml" />
  -  <!-- 
  -  <group    label="FAQs"
  -            id="faqs"
  -            title="Frequently Asked Questions">
  -    <entry  id="faq-resolvers"
  -            source="faq-resolvers.xml" />
  -  </group>
  -  -->
     <separator />
     <document label="API Docs"     
               id="api"         
  
  
  
  1.2       +2 -1      xml-security/doc/xml/sources/faq-common.xml
  
  Index: faq-common.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/faq-common.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- faq-common.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ faq-common.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,5 +1,6 @@
   <?xml version='1.0' encoding='UTF-8'?>
  -<!DOCTYPE faqs SYSTEM '../style/dtd/faqs.dtd'>
  +<!DOCTYPE faqs SYSTEM "sbk:/style/dtd/faqs.dtd">
  +
   <faqs title='Common Problems FAQs'>
    <faq title='Get some exception'>
     <q>
  
  
  
  1.2       +106 -177  xml-security/doc/xml/sources/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/faq.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- faq.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ faq.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,181 +1,110 @@
  -<?xml version="1.0" standalone="no"?> 
  -<!DOCTYPE faqs SYSTEM "../style/dtd/faqs.dtd">
  +<?xml version="1.0" standalone="no"?>
  +<!DOCTYPE faqs SYSTEM "sbk:/style/dtd/faqs.dtd">
   
   <faqs title="Frequently asked questions">
  -
  -  <faq>
  -    <q>Where's the archive for this list?</q>
  -    <a>
  -      <p>A very good question! Currently, <resource-ref
  -	  idref="mail-arch-gmane"/> is archiving the mailing list. This service
  -	also makes the mailinglist reachable with a news reader.</p>
  -      <p>If this service ever fails/stops, you can still use the ezmlm mailing
  -	list controller to recieve previous messages by email. Send an empty
  -	email to <human-resource-ref idref="mailhelp"/> for detailed information on
  -	how to use this service  </p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>Where can I learn about XML?</q>
  -    <a>
  -      <p>There are plenty of resources on the web, just use any search
  -	engine. You might start at <resource-ref idref="xmlfaq"/> or
  -	<resource-ref idref="zvon"/>.</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>Where can I learn about XML Digital Signatures?</q>
  -    <a>
  -      <p>The best place to start is <resource-ref idref="xmldsig"/>. Links on
  -	XML security in general can be found on <resource-ref
  -	  idref="christ-page"/>.</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>Where can I learn about XML Encryption?</q>
  -    <a>
  -      <p>The best place to start is <resource-ref idref="xmlenc"/>. Links on
  -	XML security in general can be found on <resource-ref
  -	  idref="christ-page"/></p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>Where can I learn about Cryptography in general?</q>
  -    <a>
  -      <p>A lot of resources exist on the web, including the 'green bible' for
  -	cryptography: <resource-ref idref="hac"/>. The &hac; is completely
  -	online and it should satisfy most of your cryptographic
  -	hunger. Disadvantage of it is that it goes rather deep, so it isn't a
  -	executive overview or a &quot;Learn XYZ in 21 days&quot;-book</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>I have a Java-(security/cryptography) problem. Can you help me?</q>
  -    <a>
  -      <p>Go to the <resource-ref idref="javaforum"/> of Sun. You can find
  -	forums where you can ask questions like &quot;How do I generate a
  -	keypair&quot;, etc.</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>I have a Java-XML problem.</q>
  -    <a>
  -      <p>Go to the <resource-ref idref="javaforum"/> of Sun, section Java
  -	Technology &amp; XML and have a look at <resource-ref idref="xml4j-used"/>.</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>I'm using crimson</q>
  -    <a>
  -      <p>You shouldn't; some people had problems with it. Use 
  -	<resource-ref idref="xml4j-used"/> instead.</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>I'm using JDK1.4.0</q>
  -    <a>
  -      <p>After SUN released the 
  -	<jump href="http://java.sun.com/j2se/1.4/index.html">
  -	  Java (TM) 2 Platform Standard Edition v1.4.0
  -	</jump>, the xml-security package stopped working. This is a 
  -	<jump href="http://developer.java.sun.com/developer/bugParade/bugs/4615582.html">
  -	  known
  -	</jump> problem: SUN packaged a beta of Xalan into the JDK1.4.0, but
  -	the xml-security package requires a stable version of Xalan (v2.2.0 or
  -	later). To fix the problem, you have to put the xalan.jar into a
  -	special directory in your JDK:
  -	<code>j2sdk1.4.0/jre/lib/endorsed/xalan.jar</code>. If you installed an
  -	out-of-the-box JDK1.4 (e.g. on Windows 2000), the &quot;endorsed&quot;
  -	directory does not exist: you'll have to create it by hand. 
  -	<em>Putting this JAR to another location like lib/ext WILL NOT
  -	  WORK.</em>
  -      </p>
  -      <p>For more on that, you can also check the 
  -	<jump href="http://xml.apache.org/~edwingo/jaxp-faq.html#override">
  -	  Unofficial JAXP FAQ
  -	</jump>.
  -      </p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>What's up with the Bouncy Castle CSP? / Where is my CSP?</q>
  -    <a>
  -      <p>There is <em>no</em> JCE bundled together with this distribution. This
  -	is because the Apache Project is hosted in the US where some export
  -	restrictions apply to the cryptographic primitives. 
  -      </p>
  -      <p>The nice guys from the 
  -	<jump href="http://www.bouncycastle.org/">Legion of Bouncy
  -	  Castle</jump> where so helpful to supply the JAR that you need to
  -	create HMAC integrity checks on their web site. When you use the ant
  -	makefile <code>build.xml</code> and simply say <code>ant compile</code>
  -	or <code>ant get-jce</code>, <code>ant</code> tries to fetch this JAR
  -	from the australian server. After that step, the compilation works
  -	completely. 
  -      </p>
  -      <p>The ant make tools initiates an automated download of the BouncyCastle
  -	JCE. The file is downloaded into the <code>libs/</code> directory and a
  -	&quot;bc-&quot; is prepended to the filename. This is done because we
  -	want the provider name (bc means BouncyCastle) being visible in the
  -	JAR's filename. </p>
  -      <p>More information can be found in the Installation section.</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>How do I enable/turn off logging?</q>
  -    <a>
  -      <p>2BDone</p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>How do I use the package to generate and verify a signature?</q>
  -    <a>
  -      <p>Checkout the samples in
  -	<code>src_samples/org/apache/xml/security/samples/signature/</code>.
  -      </p>
  -      <note>The samples divide into two groups: Samples that <em>create</em>
  -	and samples that <em>verify</em> Signatures. Eventually, you should
  -	adjust the verifying program to another filename if you get
  -	<code>FileNotFoundException</code>s.</note>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q>What is the meaning of BaseURI?</q>
  -    <a>
  -      <p>The String BaseURI is the systemID on which the Object will be stored
  -	in the future. This is needed to resolve relative links in the
  -	<code>Reference</code> elements which point to the filesystem or
  -	something similar.
  -      </p>
  -      <p>Example: Imagine that you want to create a signature to store it on a web server as 
  -         <code>http://www.acme.com/signatures/sig1.xml</code>. So
  -	<code>BaseURI=&quot;http://www.acme.com/sig1.xml&quot;</code>. This
  -	means that if you create a <code>Reference</code> with
  -	<code>URI=&quot;../index.html&quot;</code>, the library can easily use
  -	it's HTTPResourceResolver to fetch
  -	<code>http://www.acme.com/index.html</code> without that you have to
  -	say <code>URI=&quot;http://www.acme.com/index.html&quot;</code>.
  -      </p>
  -    </a>
  -  </faq>
  -
  -  <faq>
  -    <q></q>
  -    <a>
  -      <p></p>
  -    </a>
  -  </faq>
  +	<faq>
  +		<q>Where's the archive for this list?</q>
  +		<a>
  +			<p>A very good question! Currently, <resource-ref idref="mail-arch-gmane"/> is archiving the mailing list. This service also makes the mailinglist reachable with a news reader.</p>
  +			<p>If this service ever fails/stops, you can still use the ezmlm mailing list controller to recieve previous messages by email. Send an empty email to <human-resource-ref idref="mailhelp"/> for detailed information on how to use this service </p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>Where can I learn about XML?</q>
  +		<a>
  +			<p>There are plenty of resources on the web, just use any search engine. You might start at <resource-ref idref="xmlfaq"/> or <resource-ref idref="zvon"/>.</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>Where can I learn about XML Digital Signatures?</q>
  +		<a>
  +			<p>The best place to start is <resource-ref idref="xmldsig"/>. Links on XML security in general can be found on <resource-ref idref="christ-page"/>.</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>Where can I learn about XML Encryption?</q>
  +		<a>
  +			<p>The best place to start is <resource-ref idref="xmlenc"/>. Links on XML security in general can be found on <resource-ref idref="christ-page"/>
  +			</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>Where can I learn about Cryptography in general?</q>
  +		<a>
  +			<p>A lot of resources exist on the web, including the 'green bible' for cryptography: <resource-ref idref="hac"/>. The &hac; is completely online and it should satisfy most of your cryptographic hunger. Disadvantage of it is that it goes rather deep, so it isn't a executive overview or a &quot;Learn XYZ in 21 days&quot;-book</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>I have a Java-(security/cryptography) problem. Can you help me?</q>
  +		<a>
  +			<p>Go to the <resource-ref idref="javaforum"/> of Sun. You can find forums where you can ask questions like &quot;How do I generate a keypair&quot;, etc.</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>I have a Java-XML problem.</q>
  +		<a>
  +			<p>Go to the <resource-ref idref="javaforum"/> of Sun, section Java Technology &amp; XML and have a look at <resource-ref idref="xml4j-used"/>.</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>I'm using crimson</q>
  +		<a>
  +			<p>You shouldn't; some people had problems with it. Use  <resource-ref idref="xml4j-used"/> instead.</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>I'm using JDK1.4.0</q>
  +		<a>
  +			<p>After SUN released the  <jump href="http://java.sun.com/j2se/1.4/index.html"> Java (TM) 2 Platform Standard Edition v1.4.0 </jump>, the xml-security package stopped working. This is a  <jump href="http://developer.java.sun.com/developer/bugParade/bugs/4615582.html"> known </jump> problem: SUN packaged a beta of Xalan into the JDK1.4.0, but the xml-security package requires a stable version of Xalan (v2.2.0 or later). To fix the problem, you have to put the xalan.jar into a special directory in your JDK: <code>j2sdk1.4.0/jre/lib/endorsed/xalan.jar</code>. If you installed an out-of-the-box JDK1.4 (e.g. on Windows 2000), the &quot;endorsed&quot; directory does not exist: you'll have to create it by hand.  <em>Putting this JAR to another location like lib/ext WILL NOT WORK.</em>
  +			</p>
  +			<p>For more on that, you can also check the  <jump href="http://xml.apache.org/~edwingo/jaxp-faq.html#override"> Unofficial JAXP FAQ </jump>. </p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>What's up with the Bouncy Castle CSP? / Where is my CSP?</q>
  +		<a>
  +			<p>There is <em>no</em> JCE bundled together with this distribution. This is because the Apache Project is hosted in the US where some export restrictions apply to the cryptographic primitives. </p>
  +			<p>The nice guys from the <jump href="http://www.bouncycastle.org/">Legion of Bouncy Castle</jump> where so helpful to supply the JAR that you need to create HMAC integrity checks on their web site. When you use the ant makefile <code>build.xml</code> and simply say <code>ant compile</code> or <code>ant get-jce</code>, <code>ant</code> tries to fetch this JAR from the australian server. After that step, the compilation works completely.  </p>
  +			<p>The ant make tools initiates an automated download of the BouncyCastle JCE. The file is downloaded into the <code>libs/</code> directory and a &quot;bc-&quot; is prepended to the filename. This is done because we want the provider name (bc means BouncyCastle) being visible in the JAR's filename. </p>
  +			<p>More information can be found in the Installation section.</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>How do I enable/turn off logging?</q>
  +		<a>
  +			<p>2BDone</p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>How do I use the package to generate and verify a signature?</q>
  +		<a>
  +			<p>Checkout the samples in <code>src_samples/org/apache/xml/security/samples/signature/</code>. </p>
  +			<note>The samples divide into two groups: Samples that <em>create</em> and samples that <em>verify</em> Signatures. Eventually, you should adjust the verifying program to another filename if you get <code>FileNotFoundException</code>s.</note>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>What is the meaning of BaseURI?</q>
  +		<a>
  +			<p>When you work with URIs like &quot;<code>http://www.example.com/index.html</code>&quot;, it is quite sure what you mean as this is an absolute URL, i.e. it is clear which protocol ise used to fetch which file from which server. When you use such a URL inside a signature, the software can automatically figure out what you sign. But when you sign something in your local file system or if you use a relative path like &quot;<code>../1.txt</code>&quot;, it's not possible to understand this reference without some context. <em>This</em> context is the <code>BaseURI</code>. For instance, if you sign <code>URI=&quot;../1.txt&quot;</code> and the <code>BaseURI=&quot;file:///home/user/work/signature.xml&quot;</code>, it is clear that the file <code>BaseURI=&quot;file:///home/user/1.txt&quot;</code> is to be signed. But when you create the signature, the file <code>BaseURI=&quot;file:///home/user/work/signature.xml&quot;</code> does not yet exist; therefore, you have to supply the URL where you intend to store the signature later (relative to the signed objects). </p>
  +			
  +			
  +			
  +			<p>The String BaseURI is the systemID on which the Object will be stored in the future. This is needed to resolve relative links in the <code>Reference</code> elements which point to the filesystem or something similar. </p>
  +			<p>Example: Imagine that you want to create a signature to store it on a web server as  <code>http://www.acme.com/signatures/sig1.xml</code>. So <code>BaseURI=&quot;http://www.acme.com/sig1.xml&quot;</code>. This means that if you create a <code>Reference</code> with <code>URI=&quot;../index.html&quot;</code>, the library can easily use it's HTTPResourceResolver to fetch <code>http://www.acme.com/index.html</code> without that you have to say <code>URI=&quot;http://www.acme.com/index.html&quot;</code>. </p>
  +		</a>
  +	</faq>
  +	<faq>
  +		<q>Some unit tests fail: <code>org.apache.xml.security.test.c14n.implementations.ExclusiveC14NInterop.test_Y4: junit.framework.AssertionFailedError: 8 26</code></q>
  +		<a>
  +			<p>The above message states that the references nr. 8 and 26 do fail. This is because you're using a buggy version of Xalan. These references contain the XPath expression</p>
  +			<p><code>((count(ancestor-or-self::node()) mod 2) = 1)))</code></p>
  +			<p>in the XPath. If you have a look at <jump href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=9575">Bugzilla Bug 9575, count() returns wrong value on ancestor-or-self::node()</jump>, you see the bug report. Committed to CVS on 2002-07-25. Guess your Xalan is from before that date.</p>
  +		</a>
  +	</faq>
  +	<!-- TEMPLATE -->
  +	<!-- 
  +<faq>
  +  <q></q> <a> <p></p> </a> </faq>
  +-->
   </faqs>
   
  
  
  
  1.2       +1 -1      xml-security/doc/xml/sources/history.xml
  
  Index: history.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/history.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- history.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ history.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,5 +1,5 @@
   <?xml version="1.0" standalone="no"?>
  -<!DOCTYPE s1 SYSTEM "../style/dtd/document.dtd">
  +<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
   
   <s1 title="History of the project">
   <s2 title="The &lt;WebSig&gt; project">
  
  
  
  1.2       +2 -1      xml-security/doc/xml/sources/install.xml
  
  Index: install.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/install.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- install.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ install.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,5 +1,6 @@
   <?xml version="1.0" standalone="no"?>
  -<!DOCTYPE s1 SYSTEM "../style/dtd/document.dtd">
  +<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
  +
   <s1 title="Installation">
   	<s2 title="Using JDK 1.4.0">
   		<p>After SUN released the <jump href="http://java.sun.com/j2se/1.4/index.html">Java (TM) 2 Platform Standard Edition v1.4.0</jump>, the xml-security package stopped working. This is a <jump href="http://developer.java.sun.com/developer/bugParade/bugs/4615582.html">known</jump> problem: SUN packaged a beta of Xalan into the JDK 1.4.0, but the xml-security package requires a stable version of Xalan (v2.2.0 or later). To fix the problem, you have to put the xalan.jar into a special directory in your JDK: <code>j2sdk1.4.0/jre/lib/endorsed/xalan.jar</code> . If you installed an out-of-the-box JDK1.4 (e.g. on Windows 2000), the "endorsed" directory does not exist: you'll have to create it by hand. <em>Putting this JAR to another location like lib/ext WILL NOT WORK.</em></p>
  
  
  
  1.2       +1 -2      xml-security/doc/xml/sources/interop.xml
  
  Index: interop.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/interop.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- interop.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ interop.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,7 +1,6 @@
   <?xml version="1.0" standalone="no"?>
  -<!DOCTYPE s1 SYSTEM "../style/dtd/document.dtd">
  +<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
   
  -<!-- <jump href=""></jump> -->
   <s1 title="Interoperability">
           <s2 title="Problems">
              <p>In Version v1.0.4, there is one test case which fails (interop test for exclusive c14n). This is related to very esoteric node sets (The Y4 test vector from <jump href="http://www.w3.org/Signature/2002/02/01-exc-c14n-interop.html">the interop matrix</jump>). </p>
  
  
  
  1.2       +1 -1      xml-security/doc/xml/sources/readme.xml
  
  Index: readme.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/readme.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- readme.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ readme.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,5 +1,5 @@
   <?xml version="1.0" standalone="no"?>
  -<!DOCTYPE s1 SYSTEM "../style/dtd/document.dtd">
  +<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
   
   <s1 title="Readme">
   	<s2 title="News">
  
  
  
  1.2       +1 -1      xml-security/doc/xml/sources/resolvermania.xml
  
  Index: resolvermania.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/resolvermania.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- resolvermania.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ resolvermania.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,5 +1,5 @@
   <?xml version="1.0" standalone="no"?>
  -<!DOCTYPE s1 SYSTEM "../style/dtd/document.dtd">
  +<!DOCTYPE s1 SYSTEM "sbk:/style/dtd/document.dtd">
   
   <s1 title="Resolver-Mania">
   <s2 title="Why do we need all these resolvers">
  
  
  
  1.2       +39 -165   xml-security/doc/xml/sources/resources.xml
  
  Index: resources.xml
  ===================================================================
  RCS file: /home/cvs/xml-security/doc/xml/sources/resources.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- resources.xml	6 Sep 2002 07:45:30 -0000	1.1
  +++ resources.xml	9 Sep 2002 12:08:42 -0000	1.2
  @@ -1,168 +1,42 @@
   <?xml version="1.0" encoding="US-ASCII"?>
   <!DOCTYPE resources [
  -  <!ENTITY % externalEntity SYSTEM "./entities.ent">
  -  %externalEntity;
  -  <!ELEMENT resources (resource|human-resource)+>
  -  <!ELEMENT resource EMPTY>
  -  <!ATTLIST resource 		
  -        id CDATA #IMPLIED
  -				title CDATA #IMPLIED
  -				location CDATA #IMPLIED>
  -  <!ELEMENT human-resource EMPTY>
  -  <!ATTLIST human-resource 	
  -        id CDATA #IMPLIED
  -				name CDATA #IMPLIED
  -				mailto CDATA #IMPLIED>
  -   ]>  
  -<resources> 	
  -
  -  <resource id="mail-arch-gmane" title="Gmane" location="http://www.gmane.org/"/>
  -  <resource id="xmldsig" title="&xmldsig;" location="http://www.w3c.org/Signature"/>
  -  <resource id="xmlenc" title="&xmlenc;" location="http://www.w3c.org/Encryption"/>
  -  <resource id="hac" title="&hac;" location="http://www.cacr.math.uwaterloo.ca/hac/"/>
  -  <resource id="bouncy" title="Bouncy Castle Crypto API" location="http://www.bouncycastle.org/"/>
  -  <human-resource id="mailhelp" name="security-dev-help@xml.apache.org" mailto="security-dev-help@xml.apache.org"/>
  -  <resource id="zvon" title="http://www.zvon.org/" location="http://www.zvon.org/"/>
  -  <resource id="xmlfaq" title="The XML FAQ" location="http://www.ucc.ie/xml/"/>
  -  <resource id="christ-page" title="the XML Security Page" location="http://www.nue.et-inf.uni-siegen.de/~geuer-pollmann/xml_security.html"/>
  -  <resource id="javaforum" title="Java Technology Forums" location="http://forum.java.sun.com/"/>
  -
  -
  -  <resource id="xslt4j-current" 
  -            title="&xslt4j-current;" 
  -            location="http://xml.apache.org/xalan-j"/>
  -
  -  <resource id="xslt4j-distdir" 
  -            title="xalan-j distribution directory" 
  -            location="&xslt4j-distdir;"/>
  -
  -  <resource id="xslt4j-distdir-previous" 
  -            title="xalan-j previously posted builds directory" 
  -            location="&xslt4j-distdir;old"/>
  -
  -  <resource id="xslt4j-dist-zip" 
  -            title="&xslt4j-dist;.zip" 
  -            location="&xslt4j-distdir;&xslt4j-dist;.zip"/>
  -  <resource id="xslt4j-dist-targz" 
  -            title="&xslt4j-dist;.tar.gz" 
  -            location="&xslt4j-distdir;&xslt4j-dist;.tar.gz"/>
  -
  -  <resource id="xslt4j-dist-bin-zip" 
  -            title="&xslt4j-dist-bin;.zip" 
  -            location="&xslt4j-distdir;&xslt4j-dist-bin;.zip"/>
  -  <resource id="xslt4j-dist-bin-targz" 
  -            title="&xslt4j-dist-bin;.tar.gz" 
  -            location="&xslt4j-distdir;&xslt4j-dist-bin;.tar.gz"/>
  -  <resource id="xslt4j-dist-src-zip" 
  -            title="&xslt4j-dist-src;.zip" 
  -            location="&xslt4j-distdir;&xslt4j-dist-src;.zip"/>
  -  <resource id="xslt4j-dist-src-targz" 
  -            title="&xslt4j-dist-src;.tar.gz" 
  -            location="&xslt4j-distdir;&xslt4j-dist-src;.tar.gz"/>
  -
  -  <resource id="xml4j-current" 
  -            title="&xml4j;" 
  -            location="http://xml.apache.org/xerces-j/index.html"/>
  -  <resource id="xml4j-used" 
  -            title="&xml4j-used;" 
  -            location="http://xml.apache.org/xerces-j/index.html"/>
  -  <resource id="xml4j-distdir" 
  -            title="xerces-j distribution directory" 
  -            location="http://xml.apache.org/dist/xerces-j/"/>
  -  <resource id="ant" title="Ant" 
  -            location="http://jakarta.apache.org/ant/index.html"/>
  -  <resource id="ApacheLicense" 
  -            title="The Apache Software License, Version 1.1" 
  -            location="http://xml.apache.org/dist/LICENSE.txt"/>
  -  <resource id="bugzilla"
  -            title="Bugzilla (the Apache bug database)"
  -            location="http://nagoya.apache.org/bugzilla"/>
  -  <resource id="buglist"
  -            title="XalanJ2 open bugs"         
  -            location="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=XalanJ2&amp;short_desc=&amp;short_desc_type=substring&amp;long_desc=&amp;long_desc_type=substring&amp;bug_file_loc=&amp;bug_file_loc_type=substring&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;cmdtype=doit&amp;order=%27Importance%27"/>                   
  -  <resource id="bsf"
  -            title="Bean Scripting Framework (BSF)"
  -            location="http://oss.software.ibm.com/developerworks/projects/bsf"/>     
  -	
  -  <resource id="Readme" 
  -            title="Xalan Repository Release Notes" 
  -            location="http://www.apache.org/websrc/cvsweb.cgi/xml-xalan/README"/>
  -            
  -  <resource id="dpawsonxslfaq" title="XSL Frequently Asked Questions" location="http://www.dpawson.co.uk/xsl/xslfaq.html"/>
  -  
  -  <resource id="xsl" 
  -            title="Extensible Stylesheet Language (XSL) Version 1.0"
  -            location="http://www.w3.org/TR/xsl"/>
  -
  -  <resource id="xslt" 
  -            title="XSL Transformations (XSLT) Version 1.0"
  -            location="http://www.w3.org/TR/xslt"/>
  -  
  -  <resource id="xpath" 
  -            title="XML Path Language (XPath) Version 1.0" 
  -            location="http://www.w3.org/TR/xpath"/>            
  -            
  -  <resource id="dom" 
  -            title="DOM" 
  -            location="http://www.w3.org/DOM"/>
  -  <resource id="dom2" 
  -            title="DOM level 2" 
  -            location="http://www.w3.org/TR/DOM-Level-2/"/>
  -
  -  <resource id="sax" 
  -            title="SAX" 
  -            location="http://www.megginson.com/SAX/sax.html"/>
  -  <resource id="sax2" 
  -            title="SAX 2" 
  -            location="http://www.megginson.com/SAX/Java/index.html"/>
  -  <resource id="jaxp" 
  -            title="Java API for XML Parsing 1.0" 
  -            location="http://java.sun.com/xml/docs/api/index.html"/>
  -  <resource id="jaxp11" 
  -            title="Java API for XML Processing 1.1 Public Review 2" 
  -            location="http://java.sun.com/aboutJava/communityprocess/review/jsr063/jaxp-pd2.pdf"/>
  -  <resource id="jsr063"
  -            title="Java Specification Request 63"
  -            location="http://java.sun.com/aboutJava/communityprocess/review/jsr063"/>
  -            
  -  <resource id="xmlapirepository"
  -            title="xml-commons/java/external/src"
  -            location="http://cvs.apache.org/viewcvs.cgi/xml-commons/java/external/src/"/>
  -            
  -           
  -  <human-resource id="xalandev" 
  -                  name="Xalan Development Mailing List" 
  -                  mailto="xalan-dev@xml.apache.org"/>
  -                  
  -  <human-resource id="sboag"
  -                  name="Scott Boag"
  -                  mailto="scott_boag@us.ibm.com"/>
  -  <human-resource id="scurcuru"
  -                  name="Shane Curcuru"
  -                  mailto="Shane_Curcuru@us.ibm.com"/>
  -  <human-resource id="pdick"
  -                  name="Paul Dick"
  -                  mailto="Paul_Dick@us.ibm.com"/>
  -  <human-resource id="jkesselman"
  -                  name="Joseph Kesselman"
  -                  mailto="keshlam@us.ibm.com"/>
  -  <human-resource id="dleslie"
  -                  name="Donald Leslie"
  -                  mailto="donald_leslie@us.ibm.com"/>
  -  <human-resource id="cmanolache"
  -                  name="Costin Manolache"
  -                  mailto="cmanolache@yahoo.com"/>
  -  <human-resource id="dmarston"
  -                  name="David Marston"
  -                  mailto="David_Marston@us.ibm.com"/>
  -  <human-resource id="mmidy"
  -                  name="Myriam Midy"
  -                  mailto="myriam_midy@us.ibm.com"/>
  -  <human-resource id="gpeskin"
  -                  name="Gary L Peskin"
  -                  mailto="garyp@firstech.com"/>
  -  <human-resource id="jgentilin"
  -                  name="John Gentilin"
  -                  mailto="johng@apache.org"/>
  -                  
  +	<!ENTITY % externalEntity SYSTEM "sbk:/style/dtd/entities.ent">
  +	%externalEntity;
  +	<!ELEMENT resources (resource | human-resource)+>
  +	<!ELEMENT resource EMPTY>
  +	<!ATTLIST resource
  +	id CDATA #IMPLIED
  +		title CDATA #IMPLIED
  +		location CDATA #IMPLIED
  +>
  +	<!ELEMENT human-resource EMPTY>
  +	<!ATTLIST human-resource
  +	id CDATA #IMPLIED
  +		name CDATA #IMPLIED
  +		mailto CDATA #IMPLIED
  +>
  +]>
  +<resources>
  +	<resource id="mail-arch-gmane" title="Gmane" location="http://www.gmane.org/"/>
  +	<resource id="xmldsig" title="&xmldsig;" location="http://www.w3c.org/Signature"/>
  +	<resource id="xmlenc" title="&xmlenc;" location="http://www.w3c.org/Encryption"/>
  +	<resource id="hac" title="&hac;" location="http://www.cacr.math.uwaterloo.ca/hac/"/>
  +	<resource id="bouncy" title="Bouncy Castle Crypto API" location="http://www.bouncycastle.org/"/>
  +	<resource id="zvon" title="http://www.zvon.org/" location="http://www.zvon.org/"/>
  +	<resource id="xmlfaq" title="The XML FAQ" location="http://www.ucc.ie/xml/"/>
  +	<resource id="christ-page" title="the XML Security Page" location="http://www.nue.et-inf.uni-siegen.de/~geuer-pollmann/xml_security.html"/>
  +	<resource id="javaforum" title="Java Technology Forums" location="http://forum.java.sun.com/"/>
  +	<resource id="ant" title="Ant" location="http://jakarta.apache.org/ant/index.html"/>
  +	<resource id="ApacheLicense" title="The Apache Software License, Version 1.1" location="http://xml.apache.org/dist/LICENSE.txt"/>
  +	<resource id="bugzilla" title="Bugzilla (the Apache bug database)" location="http://nagoya.apache.org/bugzilla"/>
  +	<resource id="buglist" title="XalanJ2 open bugs" location="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=XalanJ2&amp;short_desc=&amp;short_desc_type=substring&amp;long_desc=&amp;long_desc_type=substring&amp;bug_file_loc=&amp;bug_file_loc_type=substring&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;cmdtype=doit&amp;order=%27Importance%27"/>
  +	<resource id="bsf" title="Bean Scripting Framework (BSF)" location="http://oss.software.ibm.com/developerworks/projects/bsf"/>
  +	<resource id="xpath" title="XML Path Language (XPath) Version 1.0" location="http://www.w3.org/TR/xpath"/>
  +	<resource id="dom" title="DOM" location="http://www.w3.org/DOM"/>
  +	<resource id="dom2" title="DOM level 2" location="http://www.w3.org/TR/DOM-Level-2/"/>
  +	<resource id="sax" title="SAX" location="http://www.megginson.com/SAX/sax.html"/>
  +	<resource id="sax2" title="SAX 2" location="http://www.megginson.com/SAX/Java/index.html"/>
  +	<resource id="jaxp" title="Java API for XML Parsing 1.0" location="http://java.sun.com/xml/docs/api/index.html"/>
  +	<human-resource id="mailhelp" name="security-dev-help@xml.apache.org" mailto="security-dev-help@xml.apache.org"/>
  +	<human-resource id="geuerp" name="Christian Geuer-Pollmann" mailto="geuerp@apache.org"/>
   </resources>