[jbosstools-commits] JBoss Tools SVN: r29812 - trunk/jsf/docs/userguide/en-US.

Author: mcaspers Date: 2011-03-15 20:34:03 -0400 (Tue, 15 Mar 2011) New Revision: 29812 Modified: trunk/jsf/docs/userguide/en-US/editors.xml trunk/jsf/docs/userguide/en-US/preferences.xml trunk/jsf/docs/userguide/en-US/vwt_faq.xml Log: "General editing and screenshot updates" Modified: trunk/jsf/docs/userguide/en-US/editors.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/editors.xml 2011-03-16 00:26:35 UTC (rev 29811) +++ trunk/jsf/docs/userguide/en-US/editors.xml 2011-03-16 00:34:03 UTC (rev 29812) @@ -94,7 +94,7 @@ </para> <para> - Use the OpenOn functionality for the next entries defined in XML file: + Use the OpenOn functionality for the next entries defined in <filename>XML</filename> file: </para> <orderedlist> @@ -493,7 +493,7 @@ <entry> <para> - Used to show navigation rules defined in the <property>faces-config.xml</property> . + Used to show navigation rules defined in the <filename>faces-config.xml</filename> . </para> </entry> </row> @@ -517,7 +517,7 @@ <entry> <para> - Used to show <property>Messages Resources</property> items. + Used to show Messages Resources items. </para> </entry> </row> @@ -587,7 +587,7 @@ <section id="JSFProjectFiles3087"> <title>JSF Project Files</title> <para> - When working with a JSF project in JBoss Developer Studio, you can use various <property>Content Assist features</property> while developing: + When working with a JSF project in JBoss Developer Studio, you can use various Content Assist features while developing: </para> <itemizedlist> @@ -611,7 +611,7 @@ <listitem> <para> - Content Assist with graphical JSF editor + Content Assist with graphical <filename>JSF</filename> editor </para> </listitem> </itemizedlist> @@ -619,7 +619,7 @@ <section id="ContentAssistForXMLJSPAndJSFConfigurationFiles865"> <title>Content Assist for XML, JSP and JSF configuration files</title> <para> - At any point when working with any XML, JSP and JSF configuration files Content Assist is available to help you. Simply press <keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo> to see what options are available. + At any point when working with any <filename>XML</filename>, <filename>JSP</filename> and <filename>JSF</filename> configuration files Content Assist is available to help you. Simply press <keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo> to see what options are available. </para> <para> @@ -693,7 +693,7 @@ <listitem> <para> - <emphasis role="italic"> <property>&quot;Managed beans&quot;</property> </emphasis> attributes and methods + Managed beans attributes and methods </para> </listitem> @@ -730,7 +730,7 @@ </figure> <para> - In the following screenshot we are inserting a <emphasis role="italic"> <property>&quot;Managed bean&quot;</property> </emphasis> attribute value. Again, by simply clicking <keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>, JBoss Developer Studio will show a list of all possible values that can be inserted. + In the following screenshot we are inserting a Managed bean attribute value. Again, by simply clicking <keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>, JBoss Developer Studio will show a list of all possible values that can be inserted. </para> <para> @@ -773,7 +773,7 @@ </figure> <para> - Moreover <property>Code Assist</property> is able to define <property>Resource Bundles</property> on template pages and provides the proposals on the client page. + Moreover Code Assist is able to define Resource Bundles on template pages and provides the proposals on the client page. </para> <figure> @@ -1012,7 +1012,7 @@ <section id="ContentAssistForEL"> <title>Content Assist for EL expressions</title> <para> - <property>Content Assist</property> also provides expression language (JSF EL) support. It is used in web application pages to access the <property>JavaBeans</property> components in the page bean and in other beans associated with the web application, such as the session bean and the application bean. + Content Assist also provides expression language (JSF EL) support. It is used in web application pages to access the JavaBeans components in the page bean and in other beans associated with the web application, such as the session bean and the application bean. </para> <figure> @@ -1247,7 +1247,7 @@ <section id="FullControlOverSourceFiles-SynchronizedSourcAndVisualEditing74"> <title>Synchronized Source and Visual Editing</title> <para> - <property>JBoss Developer Studio</property> offers the ability to edit the source code of a file, as well as providing visual editors for many file types. The source code and visual editors can be viewed and edited at the same time in a split screen view, and any changes you make in the source code editor will immediately appear in the visual editor. + JBoss Developer Studio offers the ability to edit the source code of a file, as well as providing visual editors for many file types. The source code and visual editors can be viewed and edited at the same time in a split screen view, and any changes you make in the source code editor will immediately appear in the visual editor. </para> <para> @@ -1264,7 +1264,7 @@ </figure> <para> - The same is true of all other <property>JBoss Developer Studio</property> editors. + The same is true of all other JBoss Developer Studio editors. </para> <para> @@ -1281,7 +1281,7 @@ </figure> <para> - The <property>JBoss Developer Studio</property> TLD file editor is shown below in Tree view. At any point you can edit the source by switching to the Source view. + The JBoss Developer Studio TLD file editor is shown below in Tree view. At any point you can edit the source by switching to the Source view. </para> <figure> @@ -1298,15 +1298,15 @@ <section id="visual_page" role="updated"> <title>Visual Page Editor</title> <para> - <property>JBoss Developer Studio</property> comes with a powerful and customizable <property>Visual Page Editor</property> (VPE). You can use the Visual Page Editor to develop an application using any technology such as JSF, Struts, JSP, HTML and more. Double-click on a file in the <guilabel>Package Explorer</guilabel> view to open it in the Visual Editor, or just drag-and-drop it into perspective (the drag-and-drop feature can be also applied to <filename>JSP</filename>, <filename>XHTML</filename> or <filename>HTML</filename> files created locally). + JBoss Developer Studio comes with a powerful and customizable Visual Page Editor (VPE). You can use the Visual Page Editor to develop an application using any technology such as JSF, Struts, JSP, HTML and more. Double-click on a file in the <guilabel>Package Explorer</guilabel> view to open it in the Visual Editor, or just drag-and-drop it into perspective (the drag-and-drop feature can be also applied to <filename>JSP</filename>, <filename>XHTML</filename> or <filename>HTML</filename> files created locally). </para> <para> - As a new JSF 2.0 specification has been released, support of new features is now implemented in the <property>Visual Page Editor</property>. The JSF 2.0 tags like <literal>&lt;h:body&gt;</literal>, <literal>&lt;h:head&gt;</literal>, <literal>&lt;h:outputscript&gt;</literal>, <literal>&lt;h:outputstyle&gt;</literal> are supported in the editor, as well as the composite components and expression language resource handling. (See the <ulink url="http://www.ibm.com/developerworks/java/library/j-jsf2fu2/index.... 2 fu, Part 2: Templating and composite components</ulink> for information on how to use composite components and <ulink url="http://blogs.sun.com/rlubke/entry/jsf_2_0_new_feature3">... 2.0 New Feature Preview Series (Part 2.3): Resources</ulink> on how to handle EL resources). + As a new JSF 2.0 specification has been released, support of new features is now implemented in the Visual Page Editor. The JSF 2.0 tags like <code>&lt;h:body&gt;</code>, <code>&lt;h:head&gt;</code>, <code>&lt;h:outputscript&gt;</code>, <code>&lt;h:outputstyle&gt;</code> are supported in the editor, as well as the composite components and expression language resource handling. (See the <ulink url="http://www.ibm.com/developerworks/java/library/j-jsf2fu2/index.... 2 fu, Part 2: Templating and composite components</ulink> for information on how to use composite components and <ulink url="http://blogs.sun.com/rlubke/entry/jsf_2_0_new_feature3">... 2.0 New Feature Preview Series (Part 2.3): Resources</ulink> on how to handle EL resources). </para> <para> - The current VPE version has three tabs: <property>Visual/Source</property>, <property>Source</property> and <property>Preview</property>. To switch between the views you can use tabs at the bottom of the VPE or the shortcut keys <keycombo><keycap>Ctrl</keycap><keycap>PageUp</keycap></keycombo> and <keycombo><keycap>Ctrl</keycap><keycap>PageDown</keycap></keycombo>. + The current VPE version has three tabs: <guilabel>Visual/Source</guilabel>, <guilabel>Source</guilabel> and <guilabel>Preview</guilabel>. To switch between the views you can use tabs at the bottom of the VPE or the shortcut keys <keycombo><keycap>Ctrl</keycap><keycap>PageUp</keycap></keycombo> and <keycombo><keycap>Ctrl</keycap><keycap>PageDown</keycap></keycombo>. </para> <figure> @@ -1495,7 +1495,7 @@ <section id="comments"> <title>Commenting out Code</title> <para> - <property>VPE</property> supports the ability to add comments in files you are working with (<filename>JSP</filename>, <filename>XHTML</filename>, etc.): + The Visual Page Editor supports the ability to add comments in files you are working with (<filename>JSP</filename>, <filename>XHTML</filename>, etc.): </para> <itemizedlist> @@ -1516,11 +1516,11 @@ <section id="codefolding"> <title>Using Code Folding</title> <para> - <property>Visual Page Editor</property> lets you collapse (hide) and expand (show) sections of your code to make it easier to navigate and read. + The Visual Page Editor lets you collapse (hide) and expand (show) sections of your code to make it easier to navigate and read. </para> <para> - Code folding can be enabled by right-clicking on the left margin on the Source part of Visual Page Editor, selecting <property>Folding</property> and checking the <property>Enable Folding</property> checkbox or using the <keycombo><keycap>Ctrl</keycap><keycap>Numpad Divide</keycap></keycombo> shortcut. + Code folding can be enabled by right-clicking on the left margin on the Source part of Visual Page Editor, selecting <guimenuitem>Folding</guimenuitem> and checking the <guilabel>Enable Folding</guilabel> checkbox or using the <keycombo><keycap>Ctrl</keycap><keycap>Numpad Divide</keycap></keycombo> shortcut. </para> <para> @@ -1586,7 +1586,7 @@ </para> <para> - VPE templates also provide a support for various versions of tag libraries. It means that the <property>VPE</property> takes control over those components which have different parameters or preview according to the framework version (like seam 1.2 and seam 2.0, or JSF 1.1 and JSF 1.2). + VPE templates also provide a support for various versions of tag libraries. It means that the Visual Page Editor takes control over those components which have different parameters or preview according to the framework version (like seam 1.2 and seam 2.0, or JSF 1.1 and JSF 1.2). </para> <para> @@ -1598,13 +1598,13 @@ <section id="pages_styling"> <title>Pages Styling</title> <para> - Most web pages use the cascading style sheets (CSS) to control the way they look. With <property>Visual Page Editor</property> you can easily stylize your pages. In this section we are going to introduce you to a powerful mechanism that <property>VPE</property> provides for a complete control over pages styling. More helpful information on work with CSS files can be found in <xref linkend="css_perspective"/> + Most web pages use the cascading style sheets (CSS) to control the way they look. With Visual Page Editor you can easily stylize your pages. In this section we are going to introduce you to a powerful mechanism that Visual Page Editor provides for a complete control over pages styling. More helpful information on work with CSS files can be found in <xref linkend="css_perspective"/> </para> <section id="inline_styling"> <title>Inline Style Editing</title> <para> - In the Visual part of the <property>VPE</property> there is a graphical toolbar, use it to add inline styling to JSF and Struts tags on your page. The toolbar can be hidden with the help of the special button ( + In the Visual part of the Visual Page Editor there is a graphical toolbar, use it to add inline styling to JSF and Struts tags on your page. The toolbar can be hidden with the help of the special button ( <inlinemediaobject> <imageobject> <imagedata fileref="images/visual_page/formatting_bar_icon.png"/> @@ -1623,7 +1623,7 @@ </figure> <para> - For editing inline styles for DOM elements <property>VPE</property> provides the <property>CSS Dialog</property>. It can be called from <guilabel> style</guilabel> line in the <guilabel>Properties</guilabel> view for a currently selected element. + For editing inline styles for DOM elements the Visual Page Editor provides the <guilabel>CSS Dialog</guilabel>. It can be called from <guilabel> style</guilabel> line in the <guilabel>Properties</guilabel> view for a currently selected element. </para> <figure> @@ -1652,7 +1652,7 @@ <section id="external_stylesheets"> <title>External Stylesheets</title> <para> - The pages you are working with in <property>VPE</property> can use external stylesheets. <property>VPE</property> allows you to create new style classes in existing stylesheets and/or edit them as well. For these purposes <guilabel>Edit Style Class</guilabel> Dialog is provided. + The pages you are working with in the Visual Page Editor can use external stylesheets. The Visual Page Editor allows you to create new style classes in existing stylesheets and/or edit them as well. For these purposes <guilabel>Edit Style Class</guilabel> Dialog is provided. </para> <para> @@ -1682,7 +1682,7 @@ </figure> <para> - Choose a style class from the variants provided and click on the <property>Ok</property> button to apply the changes. + Choose a style class from the variants provided and click on the <guibutton>OK</guibutton> button to apply the changes. </para> <para> @@ -1696,7 +1696,7 @@ </para> <para> - To create a new CSS class for the file click on the <property>Add CSS Class</property> button, write its name in the field appeared and click on the <property>Ok</property> button: + To create a new CSS class for the file click on the <guibutton>Add CSS Class</guibutton> button, write its name in the field appeared and click on the <guibutton>OK</guibutton> button: </para> <figure> Modified: trunk/jsf/docs/userguide/en-US/preferences.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/preferences.xml 2011-03-16 00:26:35 UTC (rev 29811) +++ trunk/jsf/docs/userguide/en-US/preferences.xml 2011-03-16 00:34:03 UTC (rev 29812) @@ -2,7 +2,7 @@ <chapter id="preferences"> <title>JBoss Tools Preferences</title> <para> - Configuring the various <property>JBoss Developer Studio</property> features is done via the <property>Preferences</property> screen by selecting <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem></menuchoice> from the menu bar. + Configuring the various <property>JBoss Developer Studio</property> features is done via the <guilabel>Preferences</guilabel> screen by selecting <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem></menuchoice> from the menu bar. </para> <figure> @@ -147,14 +147,14 @@ </itemizedlist> <para> - The <property>Preferences</property> dialog (<menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem></menuchoice> ) also allows to adjust settings for <xref linkend="JBossServerPreferences"/> and <xref linkend="XDoclet"/> module. + The <guilabel>Preferences</guilabel> dialog (<menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem></menuchoice> ) also allows to adjust settings for <xref linkend="JBossServerPreferences"/> and <xref linkend="XDoclet"/> module. </para> <section id="ProjectArchives"> <?dbhtml filename="ProjectArchives.html"?> <title>Project Archives</title> <para> - Click on the <emphasis> <property>Project Archives</property> </emphasis> to open the page for changing Project Archives preferences. + Click on the <guilabel>Project Archives</guilabel> to open the page for changing Project Archives preferences. </para> <para> @@ -1199,7 +1199,7 @@ <?dbhtml filename="StrutsCustomization"?> <title>Struts Customization</title> <para> - The following preferences can be changed on the <emphasis> <property>JBoss Tools > Web > Struts > Customization</property> </emphasis> page. + The following preferences can be changed on the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Customization</guimenuitem></menuchoice> page. </para> <para> @@ -1220,7 +1220,7 @@ <?dbhtml filename="StrutsProject.html"?> <title>Struts Project</title> <para> - You can change the following preferences on the <emphasis> <property>JBoss Tools > Web > Struts > Project</property> </emphasis> preference page: + You can change the following preferences on the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Project</guimenuitem></menuchoice> preference page: </para> <para> @@ -1254,7 +1254,7 @@ <?dbhtml filename="StrutsSupport.html"?> <title>Struts Support</title> <para> - The following preferences can be changed on the <emphasis> <property>JBoss Tools > Web > Struts > Project > Struts Support</property> </emphasis> page. + The following preferences can be changed on the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Project</guimenuitem><guimenuitem>Struts Support</guimenuitem></menuchoice> page. </para> <para> @@ -1275,7 +1275,7 @@ <?dbhtml filename="StrutsPages.html"?> <title>Struts Pages</title> <para> - You can change the following preferences on the JBoss Tools > Web > Struts > Struts Pages preference page. + You can change the following preferences on the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Struts Pages</guimenuitem></menuchoice> preference page. </para> <para> @@ -1296,7 +1296,7 @@ <?dbhtml filename="StrutsFlowDiagram.html"?> <title>Struts Flow Diagram</title> <para> - Similarly to the JSF Flow Diagram screen, selecting <emphasis> <property>JBoss Tools > Web > Editor > Struts Flow Diagram</property> </emphasis> page allows you to specify aspects of the Diagram mode of the Struts configuration file editor. The Struts Flow Diagram screen adds an option to hide the Diagram tab and labeling settings for additional artifacts. + Similarly to the JSF Flow Diagram screen, selecting <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editor</guimenuitem><guimenuitem>Struts Flow Diagram</guimenuitem></menuchoice> page allows you to specify aspects of the Diagram mode of the Struts configuration file editor. The Struts Flow Diagram screen adds an option to hide the Diagram tab and labeling settings for additional artifacts. </para> <figure> @@ -1326,7 +1326,7 @@ <?dbhtml filename="titles_diagram.html"?> <title>Tiles Diagram</title> <para> - <emphasis> <property>JBoss Tools > Web > Editors > Title Diagram</property> </emphasis> screen allows you control some settings for the placement of Tiles definitions in the Diagram mode of the JBoss Tools Tiles editor. + <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>Title Diagram</guimenuitem></menuchoice> screen allows you control some settings for the placement of Tiles definitions in the Diagram mode of the JBoss Tools Tiles editor. </para> <figure> @@ -1343,7 +1343,7 @@ <?dbhtml filename="Verification.html"?> <title>Verification</title> <para> - The following preferences can be changed on the <emphasis> <property>JBoss Tools > Web > Verification</property> </emphasis> page. + The following preferences can be changed on the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Verification</guimenuitem></menuchoice> page. </para> <para> @@ -1390,7 +1390,7 @@ </figure> <para> - On the <emphasis> <property>Server > Runtime Environments</property> </emphasis> page you can add new or modify already defined Server Runtime. + On the <menuchoice><guimenuitem>Server</guimenuitem><guimenuitem>Runtime Environments</guimenuitem></menuchoice> page you can add new or modify already defined Server Runtime. </para> <figure> @@ -1403,7 +1403,7 @@ </figure> <para> - Server Launching preferences can be configured on the <emphasis> <property>Server > Launching</property> </emphasis> page. + Server Launching preferences can be configured on the <menuchoice><guimenuitem>Server</guimenuitem><guimenuitem>Launching</guimenuitem></menuchoice> page. </para> <figure> @@ -1416,7 +1416,7 @@ </figure> <para> - Going to <emphasis> <property>Server > Audio</property> </emphasis> you can enable/disable the sound notification for different Server states and actions and set the sound volume as well. + Going to <menuchoice><guimenuitem>Server</guimenuitem><guimenuitem>Audio</guimenuitem></menuchoice> you can enable or disable the sound notification for different Server states and actions and set the sound volume as well. </para> <figure> @@ -1433,11 +1433,11 @@ <?dbhtml filename="XDoclet.html"?> <title>XDoclet</title> <para> - The preferences for XDoclet can be changed if you click <emphasis> <property>XDoclet</property> </emphasis> on the left navigation bar. + The preferences for XDoclet can be changed if you click <guilabel>XDoclet</guilabel> on the left navigation bar. </para> <para> - On the <emphasis> <property>XDoclet</property> </emphasis> screen it&apos;s possible to enable/disable XDoclet builder by checking proper box, specify XDoclet home and determine XDoclet module version as well. + On the <guilabel>XDoclet</guilabel> screen it is possible to enable or disable XDoclet builder by checking proper box, specify XDoclet home and determine XDoclet module version as well. </para> <figure> @@ -1450,7 +1450,7 @@ </figure> <para> - Switch to <emphasis> <property>XDoclet > ejbdoclet</property> </emphasis> page in order to adjust settings for EJB-specific sub-tasks. + Switch to <menuchoice><guimenuitem>XDoclet</guimenuitem><guimenuitem>ejbdoclet</guimenuitem></menuchoice> page in order to adjust settings for EJB-specific sub-tasks. </para> <figure> @@ -1463,7 +1463,7 @@ </figure> <para> - To configure settings for various web-specific XDoclet sub-tasks, follow to <emphasis> <property>XDoclet > webdoclet</property> </emphasis> page. + To configure settings for various web-specific XDoclet sub-tasks, follow to <menuchoice><guimenuitem>XDoclet</guimenuitem><guimenuitem>webdoclet</guimenuitem></menuchoice> page. </para> <figure> @@ -1590,10 +1590,7 @@ <orderedlist> <listitem> - <para>Select<emphasis> - <property> Window > Preferences > JBoss Tools > Web > {JSF or Struts} > - Project</property> - </emphasis></para> + <para>Select<menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>{JSF or Struts}</guimenuitem><guimenuitem>Project</guimenuitem></menuchoice></para> </listitem> <listitem> <para>For Project Template set the template you want to be the default one</para> Modified: trunk/jsf/docs/userguide/en-US/vwt_faq.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/vwt_faq.xml 2011-03-16 00:26:35 UTC (rev 29811) +++ trunk/jsf/docs/userguide/en-US/vwt_faq.xml 2011-03-16 00:34:03 UTC (rev 29812) @@ -1,102 +1,129 @@ -<?xml version='1.0' encoding='UTF-8'?> -<chapter id="vwt_faq"> - <?dbhtml filename="vwt_faq.html"?> - <title>FAQ</title> - - <section id="question_1"> - <title>What should I do if Visual Page Editor does not start under Linux?</title> - - <para> The <property>Visual Page Editor</property> requires the library libstdc++.so.5. This library is - contained in the compat-libstdc++-33.i386 package.</para> - - <itemizedlist> - <listitem> - <para>To install this package on Fedora Core or Red Hat Enterprise Linux run the - following command:</para> - <programlisting role="JAVA"><![CDATA[yum install compat-libstdc++-33.i386 -]]></programlisting> - </listitem> - - <listitem> - <para>On any other rpm based distributions download libstdc++.so.5 and run the - following command:</para> - <programlisting role="JAVA"><![CDATA[rpm -Uvh compat-libstdc++-33.i386 -]]></programlisting> - </listitem> - - <listitem> - <para>On Debian based distributions run the following command: </para> - <programlisting role="JAVA"><![CDATA[apt-get install compat-libstdc++-33.i386 -]]></programlisting> - </listitem> - </itemizedlist> - - <para> In case you have the library installed and you still have issue with starting the - <property>Visual Page Editor</property> then close all browser views/editors and leave one <property>Visual Page - Editor</property> open and restart eclipse. This should force a load of the right XULRunner - viewer.</para> - <para> If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1, the issue can be produced because libswt-xulrunner-gtk-3449.so file doesn't present - in eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar.To add this file to eclipse you should: - </para> - <itemizedlist> - <listitem> - <para>Decompress eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar form eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</para> - </listitem> - <listitem> - <para>Copy <property>libswt-xulrunner-gtk-3449.so</property> file to your Fedora Eclipse location. </para> - </listitem> - - <listitem> - <para>Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: </para> - <programlisting role="JAVA"><![CDATA[-Dswt.library.path=/usr/lib/eclipse -]]></programlisting><para>,where <code>/usr/lib/eclipse</code> is the path to your eclipse folder.</para> - </listitem> - </itemizedlist> - </section> - - <section id="question_2"> - <title>How do I change the auto-formating preferences for the Visual Page Editor?</title> - - <para>JBoss HTML/JSP editor uses basic eclipse HTML formatter to format files. So if you - want to change preferences of formatter for the <property>Visual Page Editor</property>, you should change it - for eclipse html editor (open <emphasis><property>Window &gt; - Preferences</property>,</emphasis> then choose <emphasis> - <property>Web &gt; HTML Files &gt; Editor</property> - </emphasis>).</para> - </section> - <section id="question_3"> - <title>Visual Editor starts OK, but the Missing Natures dialog appears</title> - - <figure> - <title>Missing Nature</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/faq/missingnauture.png"/> - </imageobject> - </mediaobject> - </figure> - - - <para> - - Some functionality of Visual Editor may not work if a project doesn't have <property>org.jboss.tools.jsf.jsfnature</property> or <property>org.jboss.tools.jst.web.kb.kbnature</property> in <property>.project</property> configuration. To fix this problem and turn off the message box execute next steps: -</para> -<orderedlist> -<listitem><para> - Right mouse button click on a project in Package Explorer. - </para></listitem> - <listitem><para> - Select <property>Configure -> Add JSF Capabilities</property> from the context menu. - </para></listitem> - <listitem><para> - Configure your project using Add JSF Capabilities wizard and press Finish. -</para></listitem> - -</orderedlist> -<para> -If you are sure that your project does not need JSF capabilities, just disable this message box by checking <property>Do not show this dialog again!</property> checkbox. - </para> - - </section> - -</chapter> +<?xml version='1.0' encoding='UTF-8'?> +<chapter id="vwt_faq"> +<?dbhtml filename="vwt_faq.html"?> + <title>FAQ</title> + <section id="question_1"> + <title>What should I do if Visual Page Editor does not start under Linux?</title> + <para> + The <property>Visual Page Editor</property> requires the library <filename>libstdc++.so.5</filename>. This library is contained in the compat-libstdc++-33.i386 package. + </para> + + <itemizedlist> + <listitem> + <para> + To install this package on Fedora Core or Red Hat Enterprise Linux run the following command: + </para> + + <programlisting role="JAVA"> +<![CDATA[yum install compat-libstdc++-33.i386 +]]> + </programlisting> + </listitem> + + <listitem> + <para> + On any other rpm based distributions download <filename>libstdc++.so.5</filename> and run the following command: + </para> + + <programlisting role="JAVA"> +<![CDATA[rpm -Uvh compat-libstdc++-33.i386 +]]> + </programlisting> + </listitem> + + <listitem> + <para> + On Debian based distributions run the following command: + </para> + + <programlisting role="JAVA"> +<![CDATA[apt-get install compat-libstdc++-33.i386 +]]> + </programlisting> + </listitem> + </itemizedlist> + + <para> + In case you have the library installed and you still have issue with starting the <property>Visual Page Editor</property> then close all browser views/editors and leave one <property>Visual Page Editor</property> open and restart eclipse. This should force a load of the right XULRunner viewer. + </para> + + <para> + If it doesn't help and you use Fedora Core Linux and Eclipse Version: 3.4.1, the issue can be produced because <filename>libswt-xulrunner-gtk-3449.so</filename> file doesn't present in <filename>eclipse-swt-3.4.1-5.fc10.x86_64.rpm/eclipse/plugins/org.eclipse.swt.gtk.linux.x86_64_3.4.1.v3449c.jar</filename>. To add this file to eclipse you should: + </para> + + <itemizedlist> + <listitem> + <para> + Decompress <filename>eclipse/plugins/org.eclipse.swt.gtk.linux.x86_3.4.1.v3449c.jar</filename> from <filename>eclipse-SDK-3.4.1-linux-gtk-x86_64.tar.gz</filename> + </para> + </listitem> + + <listitem> + <para> + Copy <filename>libswt-xulrunner-gtk-3449.so</filename> file to your Fedora Eclipse location. + </para> + </listitem> + + <listitem> + <para> + Open the file eclipse.ini,which can be found in your Fedora Eclipse location and add the following line: + </para> + + <programlisting role="JAVA"> +<![CDATA[-Dswt.library.path=/usr/lib/eclipse +]]> + </programlisting> + <para> + ,where <code>/usr/lib/eclipse</code> is the path to your eclipse folder. + </para> + </listitem> + </itemizedlist> + </section> + + <section id="question_2"> + <title>How do I change the auto-formating preferences for the Visual Page Editor?</title> + <para> + JBoss HTML/JSP editor uses basic eclipse HTML formatter to format files. So if you want to change preferences of formatter for the <property>Visual Page Editor</property>, you should change it for eclipse html editor (open <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem></menuchoice> then choose <menuchoice><guimenuitem>Web</guimenuitem><guimenuitem>HTML Files</guimenuitem><guimenuitem>Editor</guimenuitem></menuchoice>). + </para> + </section> + + <section id="question_3"> + <title>Visual Editor starts OK, but the Missing Natures dialog appears</title> + <figure> + <title>Missing Nature</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/faq/missingnauture.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Some functionality of Visual Editor may not work if a project doesn't have <code>org.jboss.tools.jsf.jsfnature</code> or <code>org.jboss.tools.jst.web.kb.kbnature</code> in <filename>.project</filename> configuration. To fix this problem and turn off the message box execute next steps: + </para> + + <orderedlist> + <listitem> + <para> + Right mouse button click on a project in Package Explorer. + </para> + </listitem> + + <listitem> + <para> + Select <menuchoice><guimenuitem>Configure</guimenuitem><guimenuitem>Add JSF Capabilities</guimenuitem></menuchoice> from the context menu. + </para> + </listitem> + + <listitem> + <para> + Configure your project using Add JSF Capabilities wizard and press Finish. + </para> + </listitem> + </orderedlist> + + <para> + If you are sure that your project does not need JSF capabilities, just disable this message box by checking <property>Do not show this dialog again!</property> checkbox. + </para> + </section> +</chapter>