[seam-commits] Seam SVN: r10920 - in branches/community/Seam_2_1/doc/Seam_Reference_Guide: bn-IN and 23 other directories.
seam-commits at lists.jboss.org
seam-commits at lists.jboss.org
Sat May 16 15:28:08 EDT 2009
Author: nico.ben
Date: 2009-05-16 15:28:07 -0400 (Sat, 16 May 2009)
New Revision: 10920
Modified:
branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Author_Group.xml
branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Dependencies.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Drools.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Events.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Excel.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Feedback.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Framework.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Glassfish.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Groovy.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Guice.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gwt.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Hsearch.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/I18n.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Itext.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jbpm.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jms.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Mail.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Performance.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Persistence.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Preface.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Remoting.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Rss.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Security.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Spring.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Testing.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Text.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tools.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tutorial.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Validation.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Weblogic.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Webservices.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Websphere.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Wicket.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Xml.pot
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Wicket.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Author_Group.po
branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Wicket.po
Log:
Regenerated POT and updated all POs
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/as-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/bn-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/de-DE/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Author_Group.xml
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Author_Group.xml 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/en-US/Author_Group.xml 2009-05-16 19:28:07 UTC (rev 10920)
@@ -110,6 +110,13 @@
<shortaffil>Italian Translation</shortaffil>
</affiliation>
</othercredit>
+ <othercredit>
+ <firstname>Francesco</firstname>
+ <surname>Milesi</surname>
+ <affiliation>
+ <shortaffil>Italian Translation</shortaffil>
+ </affiliation>
+ </othercredit>
<othercredit>
<firstname>Japan</firstname>
<surname>JBoss User Group</surname>
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-ES/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_-_Contextual_Components VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-11-06 00:08+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/es-MX/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_-_Contextual_Components VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-11-06 00:10+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/fr-FR/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/gu-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/hi-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2009-03-19 18:46+0900\n"
"Last-Translator: minamoto <minamoto at redhat.com>\n"
"Language-Team: none\n"
@@ -70,8 +70,12 @@
#. Tag: author
#: Author_Group.xml:41
#, no-c-format
-msgid "<firstname>Max</firstname> <othername>Rydahl</othername> <surname>Andersen</surname>"
-msgstr "<firstname>Max</firstname> <othername>Rydahl</othername> <surname>Andersen</surname>"
+msgid ""
+"<firstname>Max</firstname> <othername>Rydahl</othername> <surname>Andersen</"
+"surname>"
+msgstr ""
+"<firstname>Max</firstname> <othername>Rydahl</othername> <surname>Andersen</"
+"surname>"
#. Tag: author
#: Author_Group.xml:46
@@ -116,8 +120,7 @@
msgstr "<firstname>James</firstname> <surname>Cobb</surname>"
#. Tag: shortaffil
-#: Author_Group.xml:74
-#: Author_Group.xml:81
+#: Author_Group.xml:74 Author_Group.xml:81
#, no-c-format
msgid "Graphic Design"
msgstr "グラフィックデザイン"
@@ -159,8 +162,7 @@
msgstr "<firstname>Nicola</firstname> <surname>Benaglia</surname>"
#. Tag: shortaffil
-#: Author_Group.xml:103
-#: Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr "イタリア語翻訳"
@@ -173,19 +175,24 @@
#. Tag: othercredit
#: Author_Group.xml:113
+#, fuzzy, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr "<firstname>Dan</firstname> <surname>Allen</surname>"
+
+#. Tag: othercredit
+#: Author_Group.xml:120
#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr "日本語翻訳"
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr "<firstname>Samson</firstname> <surname>Kittoli</surname>"
-
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ja-JP/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -4,7 +4,7 @@
msgstr ""
"Project-Id-Version: Tools\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-03-22 12:51+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2009-02-26 14:10+0900\n"
"Last-Translator: Daisuke Sano <d-sano at nri.co.jp>\n"
"Language-Team: Japanese <fedora-trans-ja at redhat.com>\n"
@@ -207,7 +207,7 @@
"\"security\"/>を参照して下さい。"
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr "例:"
@@ -348,19 +348,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -371,34 +493,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr "アプリケーションの定義"
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -412,7 +618,7 @@
"必要です。また、ページにステータスメッセージを付加します。"
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -428,7 +634,7 @@
"ページを指定することができます。"
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -438,7 +644,7 @@
"ムページを指定することができます。"
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -472,7 +678,7 @@
"]]>"
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, fuzzy, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -483,7 +689,7 @@
"<code>WebApplication</code>クラスがどれなのかは教えてあげる必要があります。"
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, fuzzy, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -505,7 +711,7 @@
"</components]]>"
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -514,7 +720,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -531,7 +737,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/kn-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ko-KR/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ml-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/mr-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/or-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pa-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Annotations.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Author_Group.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
@@ -161,7 +161,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -175,17 +175,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Book_Info.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Cache.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Components.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Concepts.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Configuration.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Controls.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Conversations.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Dependencies.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Dependencies.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Dependencies.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Drools.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Drools.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Drools.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Elenhancements.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Events.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Events.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Events.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Excel.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Excel.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Excel.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Feedback.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Feedback.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Feedback.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Framework.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Framework.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Framework.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Getting_Started_With_JBoss_Tools.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gettingstarted.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Glassfish.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Glassfish.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Glassfish.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Groovy.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Groovy.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Groovy.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Guice.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Guice.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Guice.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gwt.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gwt.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Gwt.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Hsearch.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Hsearch.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Hsearch.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/I18n.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/I18n.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/I18n.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Itext.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Itext.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Itext.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jbpm.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jbpm.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jbpm.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jms.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jms.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Jms.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Mail.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Mail.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Mail.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Performance.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Performance.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Performance.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Persistence.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Persistence.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Persistence.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Preface.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Preface.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Preface.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Remoting.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Remoting.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Remoting.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Revision_History.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Rss.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Rss.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Rss.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Security.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Security.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Security.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Spring.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Spring.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Spring.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Testing.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Testing.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Testing.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Text.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Text.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Text.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:18+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tools.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tools.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tools.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tutorial.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tutorial.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Tutorial.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Validation.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Validation.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Validation.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Weblogic.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Weblogic.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Weblogic.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Webservices.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Webservices.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Webservices.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Websphere.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Websphere.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Websphere.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Wicket.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Wicket.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Wicket.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
@@ -167,7 +167,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -275,19 +275,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -298,34 +420,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -335,7 +541,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -346,7 +552,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -354,7 +560,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -374,7 +580,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -383,7 +589,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -399,7 +605,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -408,7 +614,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -425,7 +631,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Xml.pot
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Xml.pot 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pot/Xml.pot 2009-05-16 19:28:07 UTC (rev 10920)
@@ -6,7 +6,7 @@
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-05-10 10:19+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/pt-BR/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ru-RU/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/si-LK/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/sl-SL/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/ta-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/te-IN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:31+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-CN/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Author_Group.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Author_Group.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Author_Group.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: seam 2_0\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-02-19 21:44+0000\n"
+"POT-Creation-Date: 2009-05-16 19:18+0000\n"
"PO-Revision-Date: 2008-05-03 11:34+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -160,7 +160,7 @@
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:103 Author_Group.xml:110
+#: Author_Group.xml:103 Author_Group.xml:110 Author_Group.xml:117
#, no-c-format
msgid "Italian Translation"
msgstr ""
@@ -174,17 +174,23 @@
#. Tag: othercredit
#: Author_Group.xml:113
#, no-c-format
+msgid "<firstname>Francesco</firstname> <surname>Milesi</surname>"
+msgstr ""
+
+#. Tag: othercredit
+#: Author_Group.xml:120
+#, no-c-format
msgid "<firstname>Japan</firstname> <surname>JBoss User Group</surname>"
msgstr ""
#. Tag: shortaffil
-#: Author_Group.xml:117
+#: Author_Group.xml:124
#, no-c-format
msgid "Japanese Translation"
msgstr ""
#. Tag: editor
-#: Author_Group.xml:120
+#: Author_Group.xml:127
#, no-c-format
msgid "<firstname>Samson</firstname> <surname>Kittoli</surname>"
msgstr ""
Modified: branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Wicket.po
===================================================================
--- branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Wicket.po 2009-05-16 19:27:10 UTC (rev 10919)
+++ branches/community/Seam_2_1/doc/Seam_Reference_Guide/zh-TW/Wicket.po 2009-05-16 19:28:07 UTC (rev 10920)
@@ -5,7 +5,7 @@
msgstr ""
"Project-Id-Version: Seam_Reference_Guide \n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2008-12-27 11:29+0000\n"
+"POT-Creation-Date: 2009-05-16 19:19+0000\n"
"PO-Revision-Date: 2008-10-14 11:39+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
@@ -166,7 +166,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:211
+#: Wicket.xml:109 Wicket.xml:136 Wicket.xml:295
#, no-c-format
msgid "For example:"
msgstr ""
@@ -274,19 +274,141 @@
#, no-c-format
msgid ""
"Seam needs to instrument the bytecode of your Wicket classes to be able to "
-"intercept the annotations you use. Seam provides two ways to do this.The "
-"first is to place your classes in <code>WEB-INF/wicket</code>. Seam will "
-"look for classes placed in this directory at startup and instrument them. An "
-"alternative approach, which can be used alongside the first, is to use an "
-"ant task for instrumention. Seam provides such a task; it is packaged in "
-"<literal>jboss-seam-wicket-ant.jar </literal>, and can be used in the "
-"following manner:"
+"intercept the annotations you use. The first decision to make is: do you "
+"want your code instrumented at runtime as your app is running, or at compile "
+"time? The former requires no integration with your build environment, but "
+"has a performance penalty when loading each instrumented class for the first "
+"time. The latter is faster, but requires you to integrate this "
+"instrumentation into your build environment."
msgstr ""
-#. Tag: programlisting
+#. Tag: title
#: Wicket.xml:186
#, no-c-format
+msgid "Runtime instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:187
+#, no-c-format
msgid ""
+"There are two ways to achieve runtime instrumentation. One relies on placing "
+"wicket components to be instrumented in a special folder in your WAR "
+"deployment. If this is not acceptable or possible, you can also use an "
+"instrumentation \"agent,\" which you specify in the command line for "
+"launching your container."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:195
+#, no-c-format
+msgid "Location-specific instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:196
+#, no-c-format
+msgid ""
+"Any classes placed in the <literal>WEB-INF/wicket</literal> folder within "
+"your WAR deployment will be automatically instrumented by the seam-wicket "
+"runtime. You can arrange to place your wicket pages and components here by "
+"specifying a separate output folder for those classes in your IDE, or "
+"through the use of ant scripts."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:205
+#, no-c-format
+msgid "Runtime instrumentation agent"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:206
+#, no-c-format
+msgid ""
+"The jar file <literal>jboss-seam-wicket.jar</literal> can be used as an "
+"iinstrumentation agent through the Java Instrumentation api. This is "
+"accomplished through the following steps:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:211
+#, no-c-format
+msgid ""
+"Arrange for the <literal>jboss-seam-wicket.jar</literal> file to live in a "
+"location for which you have an absolute path, as the Java Instrumentation "
+"API does not allow relative paths when specifying the location of an agent "
+"lib."
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:216
+#, no-c-format
+msgid ""
+"Add <literal>javaagent:/path/to/jboss-seam-wicket.jar</literal> to the "
+"command line options when launching your webapp container:"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:220
+#, no-c-format
+msgid ""
+"In addition, you will need to add an environment variable that specifies "
+"packages that the agent should instrument. This is accomplished by a comma "
+"separated list of package names:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:223
+#, no-c-format
+msgid ""
+"-Dorg.jboss.seam.wicket.instrumented-packages=my.package.one,my.other.package"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:224
+#, no-c-format
+msgid ""
+"Note that if a package A is specified, classes in subpackages of A are also "
+"examined. The classes chosen for instrumentation can be further limited by "
+"specifying: <programlisting>-Dorg.jboss.seam.wicket.scanAnnotations=true</"
+"programlisting> and then marking instrumentable classes with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:234
+#, no-c-format
+msgid "Compile-time instrumentation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:235
+#, no-c-format
+msgid ""
+"Seam supports instrumentation at compile time through either Apache Ant or "
+"Apache Maven."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:238
+#, no-c-format
+msgid "Instrumenting with ant"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:239
+#, no-c-format
+msgid ""
+"Seam provides an ant task in the <literal>jboss-seam-wicket-ant.jar </"
+"literal>. This is used in the following manner:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:242
+#, no-c-format
+msgid ""
"<![CDATA[<taskdef name=\"instrumentWicket\" \n"
" classname=\"org.jboss.seam.wicket.ioc.WicketInstrumentationTask\">\n"
" <classpath>\n"
@@ -297,34 +419,118 @@
" </classpath>\n"
"</taskdef>\n"
"\n"
-"<instrumentWicket outputDirectory=\"${build.instrumented}\">\n"
+"<instrumentWicket outputDirectory=\"${build.instrumented}\" useAnnotations="
+"\"true\">\n"
" <classpath refid=\"build.classpath\"/>\n"
" <fileset dir=\"${build.classes}\" includes=\"**/*.class\"/>\n"
"</instrumentWicket>]]>"
msgstr ""
#. Tag: para
-#: Wicket.xml:187
+#: Wicket.xml:244
#, no-c-format
msgid ""
-"Then have ant copy the instrumented classes in <literal>${build.instrumented}"
-"</literal> into <literal>WEB-INF/classes</literal>. If you want to hot "
-"deploy the Wicket components, you can copy the instrumented classes to "
-"<literal>WEB-INF/dev</literal>; if you use hot deploy, make sure that your "
-"<literal>WicketApplication</literal> class is also hot-deployed. Upon a "
-"reload of hot-deployed classes, the entire WicketApplication instance has to "
-"be re-initialized, in order to pick up new references to the classes of "
-"mounted pages."
+"This results in the instrumented classes being placed in the directory "
+"specified by <literal>${build.instrumented}</literal>. You will then need to "
+"instruct ant to copy these classes into <literal>WEB-INF/classes</literal>. "
+"If you want to hot deploy the Wicket components, you can copy the "
+"instrumented classes to <literal>WEB-INF/dev</literal>; if you use hot "
+"deploy, make sure that your <literal>WicketApplication</literal> class is "
+"also hot-deployed. Upon a reload of hot-deployed classes, the entire "
+"WicketApplication instance has to be re-initialized, in order to pick up new "
+"references to the classes of mounted pages."
msgstr ""
+#. Tag: para
+#: Wicket.xml:255
+#, no-c-format
+msgid ""
+"The <literal>useAnnotations</literal> attribute is used to make the ant task "
+"only include classes that have been marked with the "
+"<literal>@SeamWicketComponent</literal> annotation, see <xref linkend="
+"\"SeamWicketComponent\"/>."
+msgstr ""
+
#. Tag: title
-#: Wicket.xml:202
+#: Wicket.xml:261
#, no-c-format
+msgid "Instrumenting with maven"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:262
+#, no-c-format
+msgid ""
+"The jboss maven repository <literal>repository.jboss.org</literal> provides "
+"a plugin named <literal>seam-instrument-wicket</literal> with a "
+"<literal>process-classes</literal> mojo. An example configuration in your "
+"pom.xml might look like: <programlisting role=\"XML\"><![CDATA[<build>\n"
+" <plugins>\n"
+" <plugin>\n"
+" <groupId>org.jboss.seam</groupId>\n"
+" <artifactId>seam-instrument-wicket</artifactId>\n"
+" <version>2.1.2</version>\n"
+" <configuration>\n"
+" <scanAnnotations>true</scanAnnotations>\n"
+" <includes>\n"
+" <include>your.package.name</"
+"include>\n"
+" </includes>\n"
+" </configuration>\n"
+" <executions>\n"
+" <execution>\n"
+" <id>instrument</id>\n"
+" <phase>process-classes</phase>\n"
+" <goals>\n"
+" <goal>instrument</goal>\n"
+" </goals>\n"
+" </execution>\n"
+" </executions>\n"
+" </plugin>\n"
+" </plugins>\n"
+"</build>]]></programlisting> The above example illustrates that the "
+"instrumentation is limited to classes specified by the <literal>includes</"
+"literal> element. In this example, the <literal>scanAnnotations</literal> is "
+"specified, see <xref linkend=\"SeamWicketComponent\"/>."
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:274
+#, no-c-format
+msgid "The <literal>@SeamWicketComponent</literal> annotation"
+msgstr ""
+
+#. Tag: para
+#: Wicket.xml:275
+#, no-c-format
+msgid ""
+"Classes placed in WEB-INF/wicket will unconditionally be instrumented. The "
+"other instrumentation mechanisms all allow you to specify that "
+"instrumentation should only be applied to classes annotated with the "
+"<literal>@SeamWicketComponent</literal> annotation. This annotation is "
+"inherited, which means all subclasses of an annotated class will also be "
+"instrumented. An example usage is:"
+msgstr ""
+
+#. Tag: programlisting
+#: Wicket.xml:280
+#, no-c-format
+msgid ""
+"<![CDATA[import org.jboss.seam.wicket.ioc.SeamWicketComponent;\n"
+"@SeamWicketComponent\n"
+"public class MyPage extends WebPage{\n"
+" ...\n"
+"}]]>"
+msgstr ""
+
+#. Tag: title
+#: Wicket.xml:286
+#, no-c-format
msgid "Defining the Application"
msgstr ""
#. Tag: para
-#: Wicket.xml:204
+#: Wicket.xml:288
#, no-c-format
msgid ""
"A Wicket web application which uses Seam should use "
@@ -334,7 +540,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:215
+#: Wicket.xml:299
#, no-c-format
msgid ""
"The <code>SeamAuthorizationStrategy</code> delegates authorization to Seam "
@@ -345,7 +551,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:223
+#: Wicket.xml:307
#, no-c-format
msgid ""
"You'll also need to set the home page of the application by implementing the "
@@ -353,7 +559,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:228
+#: Wicket.xml:312
#, no-c-format
msgid ""
"<![CDATA[public class WicketBookingApplication extends SeamWebApplication {\n"
@@ -373,7 +579,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:230
+#: Wicket.xml:314
#, no-c-format
msgid ""
"Seam automatically installs the Wicket filter for you (ensuring that it is "
@@ -382,7 +588,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:236
+#: Wicket.xml:320
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -398,7 +604,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:238
+#: Wicket.xml:322
#, no-c-format
msgid ""
"In addition, if you plan to use JSF-based pages in the same application as "
@@ -407,7 +613,7 @@
msgstr ""
#. Tag: programlisting
-#: Wicket.xml:243
+#: Wicket.xml:327
#, no-c-format
msgid ""
"<![CDATA[<components xmlns=\"http://jboss.com/products/seam/components\"\n"
@@ -424,7 +630,7 @@
msgstr ""
#. Tag: para
-#: Wicket.xml:247
+#: Wicket.xml:331
#, no-c-format
msgid ""
"Take a look at the Wicket documentation for more on authorization strategies "
More information about the seam-commits
mailing list