[seam-commits] Seam SVN: r10920 - in branches/community/Seam_2_1/doc/Seam_Reference_Guide: bn-IN and 23 other directories.

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(a)redhat.com&gt;\n&quot; "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(a)nri.co.jp&gt;\n&quot; "Language-Team: Japanese <fedora-trans-ja(a)redhat.com&gt;\n&quot; @@ -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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; @@ -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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; @@ -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@ADDRESS>\n" "Language-Team: LANGUAGE <kde-i18n-doc(a)kde.org&gt;\n&quot; 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 "