Author: ochikvina
Date: 2008-03-28 14:32:30 -0400 (Fri, 28 Mar 2008)
New Revision: 7192
Modified:
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_project_verification.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/managed_beans.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-261 - TOC in the guide is reorganized and
corrected
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml 2008-03-28
18:32:11 UTC (rev 7191)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml 2008-03-28
18:32:30 UTC (rev 7192)
@@ -16,7 +16,10 @@
<title>Create and Register a Custom Converter</title>
- <para>To create and register a custom converter it's necessary to
+ <para>With JBDS it's also possible to create a
+ custom Converter in order to specify your own converting rules.
Let's look at how you can do this.</para>
+
+ <para>To create and register a custom converter it's necessary
to
go through the following steps:</para>
<itemizedlist>
@@ -115,9 +118,7 @@
<listitem>
<para>To open a converter class click again on <emphasis>
<property>Converter-class</property>
- </emphasis> link in the Converter section. Now you
- are able to add a business logic of converter in the
- Java editor.</para>
+ </emphasis> link in the Converter section.</para>
</listitem>
</itemizedlist>
<figure>
@@ -130,7 +131,9 @@
</imageobject>
</mediaobject>
</figure>
-
+ <para>Now you
+ are able to add a business logic of converter in the
+ Java editor.</para>
</section>
<section id="CreateAndRegisterACustomValidator5632">
@@ -253,7 +256,7 @@
<title>Create and Register Referenced Beans</title>
<para>Creation of Referenced Beans is similar to creation of Custom
- Validator.</para>
+ Validator as well. To perform this, let's walk through the necessary
steps.</para>
<itemizedlist>
<listitem>
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml 2008-03-28 18:32:11
UTC (rev 7191)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml 2008-03-28 18:32:30
UTC (rev 7192)
@@ -34,9 +34,6 @@
<para>They can be selected via the tabs at the bottom of the
editor.</para>
- <para>The JSF configuration editor also comes with a very useful <link
-
linkend="OpenOnSelection4Hyperlinknavigation">OpenOn</link> selection
feature.</para>
-
<section id="Diagram9553">
<title>Diagram view</title>
@@ -54,6 +51,20 @@
</mediaobject>
</figure>
+ <para>If your diagram is large, make use of the Outline view. Within it
you can switch to a <emphasis>
+ <property>Diagram Navigator</property>
+ </emphasis> mode by selecting the middle icon at the top of the view
window. It allows
+ you to easily move around the diagram. Just move the blue area in any
direction, and the
+ diagram on the left will also move:</para>
+ <figure>
+ <title>Outline View for Diagram</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_32.png" scale="60"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
<para>To create a new page here, you should click the page icon (View
Template) on the
toolbar from the left and then click anywhere on the diagram. A New Page
Wizard will
appear.</para>
@@ -110,7 +121,7 @@
<title>Tree View</title>
- <para>The Tree mode for the editor displays all JSF application artifacts
referenced in the
+ <para>The Tree view for the editor displays all JSF application artifacts
referenced in the
configuration file in a tree format. By selecting any node you can see and
edit its
properties which will appear in the right-hand area. For example, a Managed
Bean:</para>
<figure>
@@ -141,14 +152,27 @@
</imageobject>
</mediaobject>
</figure>
+
+ <para>In the <property>Tree</property> view you can also edit
the properties of the selected
+ element with the help of the Properties view as shown below:</para>
+ <figure>
+ <title>Properties View </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_33.png" scale="75"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
</section>
<section id="SourceView4643">
<title>Source View</title>
- <para>The Source mode for the editor displays a text view of the JSF
configuration file. All
- three viewers are always synchronized, so any changes made in one of the
viewers will
- immediately appear in the others:</para>
+ <para>Here, we'll discuss how you can configure your
faces-config.xml with the help of Source View.</para>
+ <para>The Source view for the editor displays a text content of the JSF
configuration file.
+ It is always synchronized with other two views, so any changes made in one of
the views
+ will immediately appear in the other:</para>
<figure>
<title>Source View</title>
<mediaobject>
@@ -158,9 +182,24 @@
</mediaobject>
</figure>
+
+ <para>You can also work in the Source view with the help of the
<emphasis>
+ <property>Outline view</property>.</emphasis> The
Outline view shows a tree
+ structure of the JSF configuration file. Simply select any element in the
Outline view,
+ and it will jump to the same place in the Source editor, so you can navigate
through the
+ source code with Outline view.</para>
+ <figure>
+ <title>Outline View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_31.png" scale="60"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
<section id="ContentAssist976">
- <title>Code Assist</title>
+ <title>Code Assist and Open On</title>
<para>Code Assist provides pop-up tip to help you complete your code
statements. It
allows you to write your code faster and with more
accuracy.</para>
<para>Code assist is always available in the Source mode:</para>
@@ -172,6 +211,10 @@
</imageobject>
</mediaobject>
</figure>
+
+ <para>The JSF configuration editor also comes with a very useful
<link
+
linkend="OpenOnSelection4Hyperlinknavigation">OpenOn</link> selection
feature.</para>
+
</section>
<section id="ErrorReporting3324">
@@ -200,44 +243,6 @@
</mediaobject>
</figure>
- <para>You can also work in the Source editor with the help of the
<emphasis>
- <property>Outline view</property>.</emphasis> The
Outline views show a tree
- structure of the JSF configuration file. Simply select any element in the
Outline
- view, and it will jump to the same place in the Source editor, so you can
navigate
- through the source code with Outline view.</para>
- <figure>
- <title>Outline View</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_31.png" scale="60"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>If your diagram is large, within Outline view you can switch to a
<emphasis>
- <property>Diagram Navigator</property>
- </emphasis> mode by selecting the middle icon at the top of the
view window. It
- allows you to easily move around the diagram. Just move the blue area in
any
- direction, and the diagram on the left will also move:</para>
- <figure>
- <title>Outline View for Diagram</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_32.png" scale="60"/>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>You can also edit the properties of the selected element in the
- <property>Tree</property> mode with the help of the
Properties view as shown below:</para>
- <figure>
- <title>Properties View </title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_33.png" scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
</section>
</section>
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_project_verification.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_project_verification.xml 2008-03-28
18:32:11 UTC (rev 7191)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_project_verification.xml 2008-03-28
18:32:30 UTC (rev 7192)
@@ -14,6 +14,8 @@
<title>JSF Project Verification</title>
+ <para>In this chapter we'll discuss a possible verification that you
can take advantage of </para>
+
<para>JBoss Developer Studio checks for many different rules for a JSF
project that can be configured by selecting <emphasis>
<property>Window > Preferences</property>
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml 2008-03-28 18:32:11 UTC
(rev 7191)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml 2008-03-28 18:32:30 UTC
(rev 7192)
@@ -80,8 +80,9 @@
project with Facelets based on version 1.2 of the JSF
Reference
Implementation, i. e. select the <emphasis>
<property>JSF 1.2 with
Facelets</property>
- </emphasis> in the JSF Environment section of the
New JSF Project wizard.</para>
-
+ </emphasis> in the JSF Environment section of the
New JSF Project
+ wizard.</para>
+
<figure>
<title>Choosing Facelets Environment</title>
<mediaobject>
@@ -92,9 +93,9 @@
</imageobject>
</mediaobject>
</figure>
-
- <para>Once you've selected the
- environment, it's possible to specify the one of
three available templates:</para>
+
+ <para>Once you've selected the environment,
it's possible
+ to specify the one of three available
templates:</para>
<figure>
<title>Choosing Facelets Template</title>
<mediaobject>
@@ -216,8 +217,9 @@
<section>
<title>Code assist for Facelets</title>
- <para>Code assist (Ctrl + Space) for
<property>Facelets tags</property> is
- available when editing <emphasis>
+ <para>One more feature which comes with Facelets support is
code assist
+ (Ctrl + Space). It is available for
<property>Facelets tags</property>
+ while editing <emphasis>
<property>.xhtml</property>
</emphasis> files.</para>
@@ -280,7 +282,7 @@
</section>
<section>
<title>Open On feature</title>
- <para>JBDS provides Eclipse's <emphasis>
+ <para>Finally, JBDS provides Eclipse's
<emphasis>
<property>OpenOn</property>
</emphasis> feature for editing Facelets files.
Using this feature,
you can easily navigate between the
<property>Facelets
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/managed_beans.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/managed_beans.xml 2008-03-28 18:32:11
UTC (rev 7191)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/managed_beans.xml 2008-03-28 18:32:30
UTC (rev 7192)
@@ -103,7 +103,7 @@
</mediaobject>
</figure>
- <para>The generated Java source:</para>
+ <para>The generated Java source should look as follows:</para>
<figure>
<title>Java Source Code</title>
@@ -115,6 +115,7 @@
</imageobject>
</mediaobject>
</figure>
+
<para>You can also generate source code for properties, also
includes <emphasis role="italic">
<property>"getter"</property>
@@ -154,9 +155,9 @@
</figure>
<para>Once the generation is complete, you can open the file and see
the added property with <emphasis role="italic">
- <property>"getter"</property>
+ <property>"get"</property>
</emphasis> and <emphasis role="italic">
- <property>"setter"</property>
+ <property>"set"</property>
</emphasis> methods:</para>
<figure>
<title>Generated Java Source Code for Property</title>
@@ -169,7 +170,7 @@
</mediaobject>
</figure>
<para>Thus, we've discussed everything which comes to
- creating a new Managed Bean. Further we will show you how to
+ creating a new Managed Bean. The next section will show you how to
add an existing Bean into a JSF configuration file.</para>
</section>
<section id="AddExistingJavaBeansToAJSFConfigurationFile74332">
@@ -191,7 +192,7 @@
</imageobject>
</mediaobject>
</figure>
- <para>Once the class is set, it's <emphasis>
+ <para>Once the class is set, its <emphasis>
<property>Name</property>
</emphasis> will be set as well. But you can easily
substitute it for the other one. Notice that <emphasis>
@@ -223,10 +224,9 @@
<para>If you don't want to add any, just click
<emphasis>
<property>Finish</property>. </emphasis></para>
</section>
- <para>Above-listed steps have demonstrated specifying an existing Bean in
+ <para>Above-listed steps have demonstrated how you can specify an existing
Bean in
the JSF configuration file, i.e. <emphasis>
<property>faces-config.xml</property>. </emphasis> In
the
- next section you'll know how to organize and register a
- custom Converter to specify your own converting rules.</para>
+ next chapter you'll know how to organize and register another kind
of artifacts.</para>
</chapter>