You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@santuario.apache.org by mu...@apache.org on 2008/04/25 18:37:42 UTC

svn commit: r651640 - /xml/security/trunk/INSTALL

Author: mullan
Date: Fri Apr 25 09:37:41 2008
New Revision: 651640

URL: http://svn.apache.org/viewvc?rev=651640&view=rev
Log:
Made some improvements for 1.4.2 release. Removed the JCE BouncyCasle section
as that feature has been removed.

Modified:
    xml/security/trunk/INSTALL

Modified: xml/security/trunk/INSTALL
URL: http://svn.apache.org/viewvc/xml/security/trunk/INSTALL?rev=651640&r1=651639&r2=651640&view=diff
==============================================================================
--- xml/security/trunk/INSTALL (original)
+++ xml/security/trunk/INSTALL Fri Apr 25 09:37:41 2008
@@ -1,46 +1,48 @@
-XML Security v1.1.0 Released
+XML Security v1.4.2 Released
 ---------------------
-  We are proud to announce the 1.1.0 final
+  We are proud to announce the 1.4.2 final
   release of the XML Security package.
 
 About XML Security
 ------------------
   The XML Security project is an implementation of
   security related XML standards. Currently, it includes
-  implementations of W3C recommendations "Canonical XML"
-  and "XML Signature Syntax and Processing".  It also
-  includes a beta implementation of "XML Encryption
-  Syntax and Processing".
+  implementations of W3C recommendations "Canonical XML",
+  "Canonical XML 1.1", "XML Signature Syntax and Processing",
+  and "XML Encryption Syntax and Processing".
 
   Basically, this means that you can use this software
   for creating and verifying digital signatures which
   are expressed in XML and sign both XML and/or arbitrary
-  contents.
+  contents. You can use the standard JSR 105 (Java XML
+  Digital Signature) API or the non-standard Apache XMLSec API.
 
-  You can now also use the library to encrypt and decrypt
-  portions of XML documents.
+  You can also use the library to encrypt and decrypt
+  portions of XML documents. Only the non-standard Apache
+  XMLSec API is supported, as the JSR 106 (Java XML Digital Encryption) 
+  API is still in development.
 
 For more information about the XML Security project, please go to
-http://xml.apache.org/security/
+http://santuario.apache.org/
 
 For more information about XML Signature, go to
 http://www.w3.org/Signature/
 
-For pointers about XML Security in general, please go to
-http://www.nue.et-inf.uni-siegen.de/~geuer-pollmann/xml_security.html
+For more information about XML Encryption, go to
+http://www.w3.org/Encryption/
 
 ---------------------------------------------------------
 
-Downloads for XML Security v1.1.0 are available at
-http://xml.apache.org/security/dist/
+Downloads for XML Security v1.4.2 are available at
+http://xml.apache.org/security/dist/java-library/
 
 The source distibution is available at
-http://xml.apache.org/security/dist/xml-security-src-1_1_0.zip
-http://xml.apache.org/security/dist/xml-security-src-1_1_0.zip.sig
+http://xml.apache.org/security/dist/xml-security-src-1_4_2.zip
+http://xml.apache.org/security/dist/xml-security-src-1_4_2.zip.sig
 
 The binary distibution is available at
-http://xml.apache.org/security/dist/xml-security-bin-1_1_0.zip
-http://xml.apache.org/security/dist/xml-security-bin-1_1_0.zip.sig
+http://xml.apache.org/security/dist/xml-security-bin-1_4_2.zip
+http://xml.apache.org/security/dist/xml-security-bin-1_4_2.zip.sig
 
 ---------------------------------------------------------
 
@@ -53,19 +55,20 @@
 The source distibution does _not_ include
  - JavaDocs
  - the required (binary JAR) libraries.
-   The libraries are available under http://xml.apache.org/ .
    It requires
-   - Jakarta ANT (1.6 or above) as build/make tool
-   - Apache Xerces v2.6.2 or above
-     http://xml.apache.org/dist/xerces-j/
-   - Apache Xalan v2.6 or above
-   - Apache Log4J
+   - JDK 1.4.2 or above
+   - ANT (1.6 or above) as build/make tool (http://ant.apache.org)
+   - Apache commons logging (v1.0.4 or above recommended):
+     http://commons.apache.org
+   - Apache Xerces (v2.7.1 or above receommended): http://xerces.apache.org
+   - Apache Xalan (v2.7 or above recommended): http://xalan.apache.org
    - JUnit 3.7 or above
-   - A JCE Cryptographic Service Provider.
-     The distibution uses the BounceCastle JCE as a default provider.
-     When you first start ant for compiling, the JCE JAR is downloaded
-     from http://www.bouncycastle.org/ . This hook is included to
-     circumvent US export restrictions.
+
+Copy the required jars into the "libs" directory.
+If necessary, modify the ant properties in build.xml to the locations of 
+the jar files.
+Set JAVA_HOME to the JDK root directory.
+To build the binaries and run all of the tests, run "ant test".
 
 ---------------------------------------------------------
 
@@ -75,42 +78,7 @@
  - test vectors for the unit tests
  - Generated JavaDocs
  - The complete library compiled
- - All required libaries (but not the JCE which is downloaded online).
-
----------------------------------------------------------
-
-Download of the JCE
-
-The ant make tools initiates an automated download of the BouncyCastle JCE. 
-The file is downloaded into the libs/ directory and a "bc-" is prepended 
-to the filename. This is done because we want the provider name (bc means 
-BouncyCastle) being visible in the JAR's filename. 
-
-If you are a little paranoid like all security people and don't want ant to 
-make automated downloads or your firewall doesn't permit it, look in the 
-./build.xml file for the properties called
-
-<property 
-     name="jce.download.file" 
-     value="jce-jdk13-129.jar" />
-<property 
-     name="jce.download" 
-     value="http://www.bouncycastle.org/download/${jce.download.file}" />
-<property 
-     name="lib.jce"      
-     value="${libs}/bc-${jce.download.file}" />
-
-Here you can see that the file 
-
-http://www.bouncycastle.org/download/jce-jdk13-129.jar
-
-is downloaded and stored in the location 
-
-libs/bc-jce-jdk13-129.jar
-
-If you do this by hand (pointing you favourite web browser and download it 
-yourself), simply put a "bc-" in front of the filename and put it to ./libs/, 
-then ant won't try to make a download.
+ - All required libaries 
 
 ---------------------------------------------------------
 
@@ -118,5 +86,3 @@
 mailto:security-dev@xml.apache.org
 
 ---------------------------------------------------------
-
-