Author: smukhina Date: 2008-12-18 12:52:13 -0500 (Thu, 18 Dec 2008) New Revision: 12694 Modified: trunk/smooks/docs/reference/en/modules/introduction.xml trunk/smooks/docs/reference/en/modules/quick_start.xml trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml trunk/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml Log: https://jira.jboss.org/jira/browse/JBIDE-3296 correcting language for Smooks guide Modified: trunk/smooks/docs/reference/en/modules/introduction.xml =================================================================== --- trunk/smooks/docs/reference/en/modules/introduction.xml 2008-12-18 17:31:34 UTC (rev 12693) +++ trunk/smooks/docs/reference/en/modules/introduction.xml 2008-12-18 17:52:13 UTC (rev 12694) @@ -52,7 +52,7 @@ </sect1> <sect1> <title>What is Smooks dev tools?</title> - <para>Smooks dev tools is a sets of graphical tools for editing Smooks configuration file base on Eclipse.</para> + <para>Smooks dev tools is a set of graphical tools for editing Smooks configuration file base on Eclipse.</para> <figure> <title>Smooks form editor</title> <mediaobject> @@ -69,10 +69,10 @@ </link> . </para> - <para> Smooks dev tools(JBossTools) run with the latest Eclipse and other required plug-ins(GEF,EMF,etc.).</para> - <para> User should download the latest IDE for Java EE developers from this + <para> Smooks dev tools (JBossTools) run with the latest Eclipse and other required plug-ins (GEF, EMF, etc.).</para> + <para> You should download the latest IDE for Java EE developers from this <link linkend="http://www.eclipse.org/downloads/">site - </link>. It contains many plug-ins ( GEF,EMF,etc. ) required by Smooks dev tools. + </link>. It contains many plug-ins ( GEF, EMF, etc. ) required by Smooks dev tools. </para> </sect1> </chapter> Modified: trunk/smooks/docs/reference/en/modules/quick_start.xml =================================================================== --- trunk/smooks/docs/reference/en/modules/quick_start.xml 2008-12-18 17:31:34 UTC (rev 12693) +++ trunk/smooks/docs/reference/en/modules/quick_start.xml 2008-12-18 17:52:13 UTC (rev 12694) @@ -267,7 +267,7 @@ <para>Please click the &quot;Fix it&quot; link, a menu is popped-up with several "resolve methods" on it. </para> <para> Select the first resolve method: 'Connect the &quot;OrderItem&quot; to the - &quot;LineItem&quot; ', then the &quot;OrderItem&quot; was connected with the + &quot;LineItem&quot; ', then the &quot;OrderItem&quot; is connected with the &quot;LineItem&quot;. </para> <para>But the notify message area still shows some other errors: @@ -281,7 +281,7 @@ </imageobject> </mediaobject> </figure> - <para>OK, let's deal with the fire error ---- Click &quot;Fix it&quot; link and select the first resolve method. The &quot;orderItems&quot; was connected with the &quot;lineItems&quot;. + <para>OK, let's deal with the fire error ---- Click &quot;Fix it&quot; link and select the first resolve method. The &quot;orderItems&quot; is connected with the &quot;lineItems&quot;. </para> <tip> <title>Tip</title> Modified: trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml =================================================================== --- trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml 2008-12-18 17:31:34 UTC (rev 12693) +++ trunk/smooks/docs/reference/en/modules/smooksformeditor_configurationpage.xml 2008-12-18 17:52:13 UTC (rev 12694) @@ -41,7 +41,7 @@ <section id="configurationpage_parsetype"> <title>Smooks parse type</title> <para>Open the "Other configuration" section, we will see there - is a sets of radio buttons:</para> + is a set of radio buttons:</para> <figure> <title>Smooks parse type</title> <mediaobject> @@ -71,14 +71,14 @@ </figure> <para> There are three buttons on the right side of the "File Import" - list. User can click those to add/edit/remove the import files. + list. You can click those to add/edit/remove the import files. </para> <tip> <title>Tip</title> <para> If the import file dosen't exist, the image of the import file will change to "Error Image". - If user double-click the import file in + If you double-click the import file in the "Import File" list, the file will be open with a new default editor. </para> @@ -125,7 +125,7 @@ </orderedlist> </para> <para> - User can modify the parameters of the "Date Decoder" item with the + You can modify the parameters of the "Date Decoder" item with the left detail page. </para> <figure> @@ -138,7 +138,7 @@ </mediaobject> </figure> <para> - When user defined new "Date Decoder", they can use the + When you defined new "Date Decoder", they can use the <link linkend="graphicalpage_propertiesview"> "JavaBean Properties"</link> GUI to set the them to be the "Java type". </para> <!-- Modified: trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml =================================================================== --- trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml 2008-12-18 17:31:34 UTC (rev 12693) +++ trunk/smooks/docs/reference/en/modules/smooksformeditor_graphicalpage.xml 2008-12-18 17:52:13 UTC (rev 12694) @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="smooksformeditor_graphicaltab" xreflabel="Smooks Graphical Editor Page"> - <?dbhtml filename="smooks_form_editor_graphicaltab.html"?> + <?dbhtml filename="smooks_form_editor_graphicaltab.html"?> <chapterinfo> <keywordset> <keyword>JBoss Tools</keyword> @@ -9,7 +9,7 @@ </keywordset> </chapterinfo> <title>Smooks Graphical Editor Page</title> - <para> + <para> Smooks Graphical Editor Page is one tab of the Smooks Form Editor. </para> @@ -23,24 +23,24 @@ </mediaobject> </figure> <para> - This graphical editor could allow you to do drug/drop operations - with the nodes of transform data to mapping the source data to target + This graphical editor could allow you to perform drug/drop operations + with the nodes of transform data to map the source data to target data. </para> <para> - When you save the graphical editor the correct Smooks - configuration file contents + When you save the changes in the graphical editor the correct Smooks + configuration file content will be generated. </para> <section> - <title>Introduce the areas of graphical editor</title> - <para> Please, read the + <title>Introducing the areas of graphical editor</title> + <para>Information on the topic could be found here <link linkend="quickstart_formeditor">"Quick Start/Smooks Form Editor"</link> </para> </section> <section> <title>Load source/target data</title> - <para> Click the links under the data viewer, the data type selection wizard page will be shown. + <para> Click the links under the data viewer, the data type selection wizard page will be shown. </para> <figure> <title>Data type selection wizard page</title> @@ -51,7 +51,7 @@ </imageobject> </mediaobject> </figure> - <para> There are a sets of transform data type on the wizard page,select one type and click + <para> There are sets of transform data type on the wizard page, select one type and click <property>Next</property> , the data source selection wizard page will be shown. <tip> @@ -79,21 +79,21 @@ </imageobject> </mediaobject> </figure> - <para> When finish the data selection(file path selection), Click + <para> When you finish the data selection (file path selection), Click <property>Finish</property> , the data viewer will display the selected data structure. </para> </section> <section> - <title>Use the graphical editor to mapping</title> - <para> Please, read the + <title>Using the graphical editor for mapping</title> + <para>To get information on the topic please, read the <link linkend="quickstart_mapping">"Quick Start/Mapping"</link> </para> </section> <section> <title>Error messages</title> - <para> When you do any mapping operations, the Smooks tools will validate the file contents with "Mapping Logic", If there is any errors of the configuration file contents - ,error messages will be shown on the + <para>When you do any mapping operations, the Smooks tools validates the file content with "Mapping Logic", If there is any errors of the configuration file content + , error messages are shown on the <link linkend="quickstart_formeditor">"Error message area"</link> . @@ -104,36 +104,35 @@ </section> <section id="graphicalpage_propertiesview"> <title>Properties Viewer</title> - <para> You can edit the properties of the "connection lines" with the properties viewer. + <para> You can edit the properties of the "connection lines" with the properties viewer. </para> - <para> Select the menu: "Window -> Show View -> Other -> Properties", the properties viewer will be opened. + <para> Select the menu: "Window -> Show View -> Other -> Properties", the properties viewer is opened. </para> <para> When you select on the connection lines, the properties viewer - will show a sets of section GUI for editing the properties of the + will show a set of section GUI for editing the properties of the connection line. </para> <tip> - <title>Note</title> + <title>Tip</title> <para> - These GUI on the properties viewer will be displayed when the + This GUI on the properties viewer is displayed when the "Smooks - Graphical Page" was active,if not the properties viewer will - display empty GUI. + Graphical Page" is active, if not, the properties viewer + displays empty GUI. </para> <para> - If the source data type of the selected connection line was - "XML",The properties viewer will show a "XML Properties" section + If the source data type of the selected connection line is + "XML", The properties viewer shows a "XML Properties" section GUI. </para> <para> - But the source data type of the selected connection line was - "Java", - the "XML Properties" section GUI doesn't display. + But if the source data type of the selected connection line is + "Java", the "XML Properties" section GUI isn't 'displayed. </para> <para> It means that if the source/target data type of the selected - connection line was different, the properties viewer will show + connection line is different, the properties viewer shows different GUI. </para> </tip> Modified: trunk/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml =================================================================== --- trunk/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml 2008-12-18 17:31:34 UTC (rev 12693) +++ trunk/smooks/docs/reference/en/modules/smooksformeditor_sourcepage.xml 2008-12-18 17:52:13 UTC (rev 12694) @@ -11,7 +11,7 @@ <title>Smooks Source Editor Page</title> <section> <title>XML Source Editor</title> - <para> User can use this editor to edit the Smooks configuration file directly. + <para>You can use this editor to edit the Smooks configuration file directly. </para> <figure> <title>Graphical Editor</title> @@ -25,7 +25,7 @@ </section> <section> <title>Error Messages GUI</title> - <para> If the Smooks tools can't understand the configuration file or the configuration file was illegal(XML structure isn't right for Smooks configuration file, etc.),The error message panel will display above the XML editor. + <para>If the Smooks tools can't understand the configuration file or the configuration file is illegal (XML structure isn't right for Smooks configuration file, etc.), The error message panel will be displayed above the XML editor. </para> <figure> <title>Graphical Editor</title> @@ -36,16 +36,16 @@ </imageobject> </mediaobject> </figure> - <tip> - <title>Note</title> + <note> + <title>Tip</title> <para> - When the error message panel was displayed, other editors ( - Graphical Editor, Configuration Editor ) will be disabled. + When the error message panel is displayed, other editors ( + Graphical Editor, Configuration Editor ) are disabled. </para> <para> - User can't edit the configuration file with other editors until - file was right. + You can't edit the configuration file with other editors until + file becomes valid. </para> - </tip> + </note> </section> </chapter> \ No newline at end of file