From weld-commits at lists.jboss.org Mon Oct 19 18:44:37 2009
Content-Type: multipart/mixed; boundary="===============5648396247424168749=="
MIME-Version: 1.0
From: weld-commits at lists.jboss.org
To: weld-commits at lists.jboss.org
Subject: [weld-commits] Weld SVN: r4202 - cdi-tck/trunk/doc/reference/en-US.
Date: Mon, 19 Oct 2009 18:44:37 -0400
Message-ID: <200910192244.n9JMibR8018968@svn01.web.mwc.hst.phx2.redhat.com>

--===============5648396247424168749==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: shane.bryzak(a)jboss.com
Date: 2009-10-19 18:44:36 -0400 (Mon, 19 Oct 2009)
New Revision: 4202

Modified:
   cdi-tck/trunk/doc/reference/en-US/sigtest.xml
Log:
updated sigtest section of docs


Modified: cdi-tck/trunk/doc/reference/en-US/sigtest.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- cdi-tck/trunk/doc/reference/en-US/sigtest.xml	2009-10-19 22:09:42 UTC (=
rev 4201)
+++ cdi-tck/trunk/doc/reference/en-US/sigtest.xml	2009-10-19 22:44:36 UTC (=
rev 4202)
@@ -10,8 +10,9 @@
    <section>
      <title>Obtaining the sigtest tool</title>
      <para>
-       You can obtain the Sigtest tool from the Sigtest home page at <ulin=
k url=3D"https://sigtest.dev.java.net/"/>.  =

-       The user guide can be found at <ulink url=3D"http://java.sun.com/ja=
vame/sigtest/docs/sigtest2.1_usersguide.pdf"/>.
+       You can obtain the Sigtest tool (at the time of writing the TCK use=
s version 2.1) from the Sigtest home =

+       page at <ulink url=3D"https://sigtest.dev.java.net/"/>. The user gu=
ide can be found at =

+       <ulink url=3D"http://java.sun.com/javame/sigtest/docs/sigtest2.1_us=
ersguide.pdf"/>.
      </para>
    </section>
    =

@@ -21,28 +22,26 @@
         The general command for generating a signature file looks like thi=
s:
       </para>
       =

-      <programlisting><![CDATA[
-java -cp %JAVA_HOME%\jre\lib\rt.jar%;sigtestdev.jar com.sun.tdk.signaturet=
est.Setup -Package javax.decorator -Package javax.enterprise -Package javax=
.event -Package javax.inject -Package javax.interceptor -FileName weld.sig =
-Classpath .;%JAVA_HOME%\jre\lib\rt.jar -static]]></programlisting>
+      <programlisting><![CDATA[java -jar sigtestdev.jar Setup -classpath "=
%JAVA_HOME%\jre\lib\rt.jar:cdi-api.jar:javax.inject.jar:el-api.jar:jboss-in=
terceptor-api.jar" -Package javax.decorator -Package javax.enterprise -File=
Name cdi-api.sig -static]]></programlisting>
 =

       <para>
-        Here's a working example with the classpaths filled out:
+        Usually all the required libraries will be located in a local Mave=
n repository, so here's a working example with the =

+        classpaths filled out:
       </para>
       =

-      <programlisting><![CDATA[
-java -cp %JAVA_HOME%\jre\lib\rt.jar;/home/shane/java/sigtest-2.0/lib/sigte=
stdev.jar com.sun.tdk.signaturetest.Setup -Package javax.decorator -Package=
 javax.enterprise -Package javax.event -Package javax.inject -Package javax=
.interceptor -FileName weld.sig -Classpath .;%JAVA_HOME%/jre/lib/rt.jar;/ho=
me/shane/.m2/repository/org/jboss/weld/jsr299-api/1.0.0-SNAPSHOT/jsr299-api=
-1.0.0-SNAPSHOT.jar;/home/shane/.m2/repository/javax/el/el-api/1.2/el-api-1=
.2.jar -static]]></programlisting>
+      <programlisting><![CDATA[java -jar  "/home/shane/java/sigtest-2.1/li=
b/sigtestdev.jar" Setup -classpath "/usr/local/java/jre/lib/rt.jar:/home/sh=
ane/.m2/repository/javax/enterprise/cdi-api/1.0.0-SNAPSHOT/cdi-api-1.0.0-SN=
APSHOT.jar:/home/shane/.m2/repository/javax/inject/javax.inject/1.0-PFD-1/j=
avax.inject-1.0-PFD-1.jar:/home/shane/.m2/repository/javax/el/el-api/2.1.2-=
b04/el-api-2.1.2-b04.jar:/home/shane/.m2/repository/org/jboss/interceptor/j=
boss-interceptor-api/3.1.0-CR1/jboss-interceptor-api-3.1.0-CR1.jar" -Packag=
e javax.decorator -Package javax.enterprise -FileName cdi-api.sig -static]]=
></programlisting>      =

    </section>
    =

    <section>
      <title>Running the signature test</title>
      =

-     <para>To run the signature test simply change the execution class fro=
m <literal>Setup</literal> to <literal>SignatureTest</literal>:</para>
+     <para>To run the signature test simply change the execution command f=
rom <literal>Setup</literal> to <literal>SignatureTest</literal>:</para>
 =

-     <programlisting><![CDATA[
-java -cp %JAVA_HOME%\jre\lib\rt.jar%;sigtestdev.jar com.sun.tdk.signaturet=
est.SignatureTest -Package javax.decorator -Package javax.enterprise -Packa=
ge javax.event -Package javax.inject -Package javax.interceptor -FileName w=
eld.sig -Classpath .;%JAVA_HOME%\jre\lib\rt.jar -static]]></programlisting>
+      <programlisting><![CDATA[java -jar sigtestdev.jar SignatureTest -cla=
sspath "%JAVA_HOME%\jre\lib\rt.jar:cdi-api.jar:javax.inject.jar:el-api.jar:=
jboss-interceptor-api.jar" -Package javax.decorator -Package javax.enterpri=
se -FileName cdi-api.sig -static]]></programlisting>
 =

-     <para>Here's a working example:</para>
+     <para>Once again, here's a working example:</para>
 =

-     <programlisting><![CDATA[java -cp %JAVA_HOME%\jre\lib\rt.jar;/home/sh=
ane/java/sigtest-2.0/lib/sigtestdev.jar com.sun.tdk.signaturetest.Signature=
Test -Package javax.decorator -Package javax.enterprise -Package javax.even=
t -Package javax.inject -Package javax.interceptor -FileName weld.sig -Clas=
spath .;%JAVA_HOME%\jre\lib\rt.jar;/home/shane/.m2/repository/org/jboss/wel=
d/jsr299-api/1.0.0-SNAPSHOT/jsr299-api-1.0.0-SNAPSHOT.jar;/home/shane/.m2/r=
epository/javax/el/el-api/1.2/el-api-1.2.jar -static]]></programlisting>
+     <programlisting><![CDATA[java -jar  "/home/shane/java/sigtest-2.1/lib=
/sigtestdev.jar" SignatureTest -classpath "/usr/local/java/jre/lib/rt.jar:/=
home/shane/.m2/repository/javax/enterprise/cdi-api/1.0.0-SNAPSHOT/cdi-api-1=
.0.0-SNAPSHOT.jar:/home/shane/.m2/repository/javax/inject/javax.inject/1.0-=
PFD-1/javax.inject-1.0-PFD-1.jar:/home/shane/.m2/repository/javax/el/el-api=
/2.1.2-b04/el-api-2.1.2-b04.jar:/home/shane/.m2/repository/org/jboss/interc=
eptor/jboss-interceptor-api/3.1.0-CR1/jboss-interceptor-api-3.1.0-CR1.jar" =
-Package javax.decorator -Package javax.enterprise -FileName cdi-api.sig -s=
tatic]]></programlisting>
 =

      <para>When running the signature test, you may get the following mess=
age:</para>
 =

@@ -56,36 +55,43 @@
      =

      <para>Just for fun (and to confirm that the signature test is working=
 correctly), you can try the following:</para>
 =

-     <para>1) Edit weld.sig</para>
+     <para>1) Edit cdi-api.sig</para>
      =

-     <para>2) Modify one of the class signatures - in the following exampl=
e we change one of the constructors for <literal>NullableDependencyExceptio=
n</literal> - here's the original:</para>
+     <para>2) Modify one of the class signatures - in the following exampl=
e we change one of the constructors for <literal>BusyConversationException<=
/literal> - here's the original:</para>
 =

-     <programlisting><![CDATA[
-CLSS public javax.inject.NullableDependencyException
-cons public NullableDependencyException()
-cons public NullableDependencyException(java.lang.String)]]></programlisti=
ng>
+     <programlisting><![CDATA[CLSS public javax.enterprise.context.BusyCon=
versationException
+cons public BusyConversationException()
+cons public BusyConversationException(java.lang.String)
+cons public BusyConversationException(java.lang.String,java.lang.Throwable)
+cons public BusyConversationException(java.lang.Throwable)
+supr javax.enterprise.context.ContextException
+hfds serialVersionUID
+]]></programlisting>
 =

-     <para>Let's change the constructor parameter to a <literal>java.lang.=
Integer</literal> instead:</para>
+     <para>Let's change the default (empty) constructor parameter to one w=
ith a <literal>java.lang.Integer</literal>parameter instead:</para>
 =

-     <programlisting><![CDATA[
-CLSS public javax.inject.NullableDependencyException
-cons public NullableDependencyException()
-cons public NullableDependencyException(java.lang.Integer)]]></programlist=
ing>
+     <programlisting><![CDATA[CLSS public javax.enterprise.context.BusyCon=
versationException
+cons public BusyConversationException(java.lang.Integer)
+cons public BusyConversationException(java.lang.String)
+cons public BusyConversationException(java.lang.String,java.lang.Throwable)
+cons public BusyConversationException(java.lang.Throwable)
+supr javax.enterprise.context.ContextException
+hfds serialVersionUID
+]]></programlisting>
 =

-     <para>3) Now we run the signature test using the above command, which=
 should result in the following errors:</para>
+     <para>3) Now when we run the signature test using the above command, =
we should get the following errors:</para>
 =

-     <programlisting><![CDATA[
-Missing Constructors
---------------------
-
-javax.inject.NullableDependencyException:                   constructor pu=
blic javax.inject.NullableDependencyException.NullableDependencyException(j=
ava.lang.Integer)
-
-Added Constructors
-------------------
-
-javax.inject.NullableDependencyException:                   constructor pu=
blic javax.inject.NullableDependencyException.NullableDependencyException(j=
ava.lang.String)
-
-
+     <programlisting><![CDATA[Missing Constructors
+--------------------
+
+javax.enterprise.context.BusyConversationException:         constructor pu=
blic javax.enterprise.context.BusyConversationException.BusyConversationExc=
eption(java.lang.Integer)
+
+Added Constructors
+------------------
+
+javax.enterprise.context.BusyConversationException:         constructor pu=
blic javax.enterprise.context.BusyConversationException.BusyConversationExc=
eption()
+
+
 STATUS:Failed.2 errors]]></programlisting>   =

    </section>
    =



--===============5648396247424168749==--