Author: ochikvina Date: 2009-05-12 08:50:47 -0400 (Tue, 12 May 2009) New Revision: 15227 Added: trunk/drools/docs/guvnor_ref/ trunk/drools/docs/guvnor_ref/en/ trunk/drools/docs/guvnor_ref/en/images/ trunk/drools/docs/guvnor_ref/en/images/functionality_overview/ trunk/drools/docs/guvnor_ref/en/images/functionality_overview/add_toGuvnor_wizard.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/association_details.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version2.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version3.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/confirm_delete.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/delete_connection_button.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/do_into_button.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_back_button.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_home_button.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_into_button.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_into_defaultPackage.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_connection_button.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_connection_wizard.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_preferences.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_repository.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnorinfo.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/open_guvnor_perspectine.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/repository_files_properties.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor2.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor3.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view2.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view3.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/select_target_folder.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/start_guvnor_connection1.png trunk/drools/docs/guvnor_ref/en/images/functionality_overview/start_guvnor_connection2.png trunk/drools/docs/guvnor_ref/en/images/guvnor_preferences/ trunk/drools/docs/guvnor_ref/en/images/guvnor_preferences/guvnor_preferences.png trunk/drools/docs/guvnor_ref/en/master.xml trunk/drools/docs/guvnor_ref/en/modules/ trunk/drools/docs/guvnor_ref/en/modules/conclusion.xml trunk/drools/docs/guvnor_ref/en/modules/functionality_overview.xml trunk/drools/docs/guvnor_ref/en/modules/guvnor_preferences.xml trunk/drools/docs/guvnor_ref/en/modules/introduction.xml trunk/drools/docs/guvnor_ref/pom.xml Log: https://jira.jboss.org/jira/browse/JBDS-451 - adding Guvnor Tools Reference guide; Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/add_toGuvnor_wizard.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/add_toGuvnor_wizard.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/association_details.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/association_details.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version2.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version3.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/compare_with_version3.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/confirm_delete.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/confirm_delete.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/delete_connection_button.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/delete_connection_button.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/do_into_button.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/do_into_button.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_back_button.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_back_button.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_home_button.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_home_button.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_into_button.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_into_button.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_into_defaultPackage.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/go_into_defaultPackage.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_connection_button.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_connection_button.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_connection_wizard.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_connection_wizard.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_preferences.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_preferences.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_repository.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnor_repository.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnorinfo.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/guvnorinfo.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/open_guvnor_perspectine.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/open_guvnor_perspectine.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/repository_files_properties.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/repository_files_properties.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor2.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor3.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_from_guvnor3.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view2.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view3.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/resource_history_view3.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/select_target_folder.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/select_target_folder.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/start_guvnor_connection1.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/start_guvnor_connection1.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/start_guvnor_connection2.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/functionality_overview/start_guvnor_connection2.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/images/guvnor_preferences/guvnor_preferences.png =================================================================== (Binary files differ) Property changes on: trunk/drools/docs/guvnor_ref/en/images/guvnor_preferences/guvnor_preferences.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Added: trunk/drools/docs/guvnor_ref/en/master.xml =================================================================== --- trunk/drools/docs/guvnor_ref/en/master.xml (rev 0) +++ trunk/drools/docs/guvnor_ref/en/master.xml 2009-05-12 12:50:47 UTC (rev 15227) @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" +"http://www.docbook.org/xsd/4.3/docbook.xsd" + +[<!ENTITY introduction SYSTEM "modules/introduction.xml"> +<!ENTITY functionality_overview SYSTEM "modules/functionality_overview.xml"> +<!ENTITY guvnor_preferences SYSTEM "modules/guvnor_preferences.xml"> +<!ENTITY conclusion SYSTEM "modules/conclusion.xml"> + +<!ENTITY seamlink "../../seam/html_single/index.html"> +<!ENTITY aslink "../../as/html_single/index.html"> +<!ENTITY esblink "../../esb_ref_guide/html_single/index.html"> +<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html"> +<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html"> +<!ENTITY jbpmlink "../../jbpm/html_single/index.html"> +<!ENTITY jsflink "../../jsf/html_single/index.html"> +<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html"> +<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html"> +<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html"> +<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html"> + +]> + +<book> + + <bookinfo> + <title>Eclipse Guvnor Tools Reference Guide</title> + + <author&gt;&lt;firstname&gt;John&lt;/firstname&gt;&lt;surname&gt;Graham&lt;/surname&gt;&lt;email&gt;jgraham(a)redhat.com&lt;/email&gt;&lt;/author&gt; + <author><firstname>Olga</firstname><surname>Chikvina</surname></author> + + <pubdate>April 2008</pubdate> + <copyright> + <year>2009</year> + <holder>JBoss, a division of Red Hat</holder> + </copyright> + <!--releaseinfo> + Version: 5.0.0.M5 + </releaseinfo--> +<abstract> + <title/> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/guvnor/pdf... version</ulink> + </para> + </abstract> + + </bookinfo> + + + <toc/> + &introduction; + &functionality_overview; + &guvnor_preferences; + &conclusion; + +</book> Added: trunk/drools/docs/guvnor_ref/en/modules/conclusion.xml =================================================================== --- trunk/drools/docs/guvnor_ref/en/modules/conclusion.xml (rev 0) +++ trunk/drools/docs/guvnor_ref/en/modules/conclusion.xml 2009-05-12 12:50:47 UTC (rev 15227) @@ -0,0 +1,22 @@ +<?xml version='1.0' encoding='UTF-8'?> +<chapter id="conclusion" xreflabel="conclusion"> + <?dbhtml filename="conclusion.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Eclipse Guvnor Tools</keyword> + </keywordset> + </chapterinfo> + + <title>Conclusion</title> + + <para>As stated at the beginning of this document, the key goal of the <property>EGT</property> + is to provide a way of interacting with Guvnor repository resources in a local Eclipse + workspace. While clearly there is a lot more that could be done, and no doubt there will be + aspects of the current tooling that require revision going forward, we feel that the current + state of the <property>EGT</property> is sufficient for the major use cases.</para> + + <para>If you have some questions, comments or suggestions on the topic, please feel free to ask in the + <ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&... + >Jboss Tools Forum</ulink>.</para> +</chapter> Added: trunk/drools/docs/guvnor_ref/en/modules/functionality_overview.xml =================================================================== --- trunk/drools/docs/guvnor_ref/en/modules/functionality_overview.xml (rev 0) +++ trunk/drools/docs/guvnor_ref/en/modules/functionality_overview.xml 2009-05-12 12:50:47 UTC (rev 15227) @@ -0,0 +1,727 @@ +<?xml version='1.0' encoding='UTF-8'?> +<chapter id="functionality_overview" xreflabel="functionality_overview"> + <?dbhtml filename="functionality_overview.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Eclipse Guvnor Tools</keyword> + </keywordset> + </chapterinfo> + + <title>Functionality Overview</title> + + <para>This chapter will introduce you to the <property>Guvnor Repository Exploring + perspective</property> and give an overview on all functionality the <property>Guvnor Tools</property> provides.</para> + + <section id="guvnor_perspective"> + <title>Guvnor Perspective</title> + + <para>The <property>Guvnor Repository Exploring perspective</property> contains two views + supplied by <property>EGT</property> – <property>Repository Explorer</property> and + <property>Version History</property>, that will be the center of most interaction + with Guvnor, and Eclipse standard views such as <property>Properties</property> and + <property>Resource Navigator</property> that are also useful.</para> + + <para>While each of these views can be opened and positioned independently within an Eclipse + workbench, the <property>Guvnor perspective</property> provides a convenient method of + getting a suggested layout. In the Eclipse workbench menu, choose <emphasis> + <property>Window &gt; Open Perspective &gt; Other</property> + </emphasis> to get the perspective list:</para> + + <figure> + <title>Enabling the Guvnor Repository Perspective</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/open_guvnor_perspectine.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>And then choose <emphasis> + <property>Guvnor Repository Exploring</property>.</emphasis> This opens the + <property>Guvnor perspective</property>.</para> + </section> + + <section id="connection_wizard"> + <title>Guvnor Connection Wizard</title> + + <para>After opening the <property>Guvnor perspective</property>, the first task is to make a + connection to a Guvnor repository. This is handled by the <property>Guvnor Connection + wizard</property>. This wizard appears in a number of places within the + <property>EGT</property> (as detailed below), but in this section we will cover only + the two most basic entry points.</para> + + <para>The <property>Guvnor Connection wizard</property> can be started in the following + ways:</para> + + <itemizedlist> + <listitem> + <para>using the Eclipse menu <emphasis> + <property>File &gt; New &gt; Other &gt; Guvnor &gt; Guvnor + repository location</property> + </emphasis></para> + + <figure> + <title>New Guvnor Repository Location</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/start_guvnor_connection1.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + + <listitem> + <para>in the <property>Guvnor Repositories view</property> using the drop-down menu</para> + + <figure> + <title>Adding New Guvnor Connection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/start_guvnor_connection2.png"/> + </imageobject> + </mediaobject> + </figure> + </listitem> + + <listitem> + <para>using the menu button + ( <inlinemediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/guvnor_connection_button.png"/> + </imageobject> + </inlinemediaobject> ) + </para> + </listitem> + </itemizedlist> + + <para>Choosing either of these will start the <property>Guvnor Connection + wizard</property>.</para> + + <figure id="guvnor_connection_wizard"> + <title>Guvnor Connection Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/guvnor_connection_wizard.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Default values appear in the <emphasis> + <property>Location</property>,</emphasis> + <emphasis> + <property>Port</property>,</emphasis> and <emphasis> + <property>Repository</property> + </emphasis> fields (See the <link linkend="guvnor_preferences">“Guvnor Preferences”</link> section below for details about how to + change these default values.) Of course, any of these fields can be edited by typing in + the corresponding text box. Drag-and-drop or paste into the <emphasis> + <property>Location</property> + </emphasis> field of a typical Guvnor repository URL such as:</para> + + <para> + <emphasis> + <property>http://localhost:8080/drools-guvnor/org.drools.guvnor.Guvnor/webdav</property> + </emphasis> + </para> + + <para>Results in the URL being parsed into the respective fields as well. The authentication + information (user name and password) can optionally be stored in the Eclipse + workbench&apos;s key-ring file based on the selection of <emphasis> + <property>Save user name and password</property>.</emphasis></para> + + <note> + <title>Note:</title> + <para>If the authentication information is not stored in the key-ring, then the + <property>EGT</property> uses a session authentication, what means that the + credentials supplied are used only for the lifetime of the Eclipse workbench + instance.</para> + </note> + + <para>If authentication information is not stored in the key-ring or the authentication + information (key-ring or session) is not valid, the <property>EGT</property> will prompt + for authentication information when it has to access the Guvnor repository.</para> + + <para>If authentication fails, the <property>EGT</property> will retry once and then issue + an authentication failure error.</para> + + <tip> + <title>Tip:</title> + <para>If an authentication failure error occurs, you can retry the same operation and + supply different authentication information.</para> + </tip> + + <para>Note that the <property>EGT</property> calls the Guvnor repository at various times, + such as when determining if resource updates are available. Thus if you use session + authentication, the authentication dialog will appear at different times during the + Eclipse workbench session, depending on what actions you take. For ease of use, we + recommend saving the authentication information in the Eclipse key-ring.</para> + + <note> + <title>Note:</title> + <para>The Eclipse key-ring file is distinct from key-ring files found in some platforms + such as Mac OS X and many forms of Linux. Thus, sometimes if you access a Guvnor + repository outside the <property>EGT</property>, the key-ring files might become + unsynchronized and you will be unexpectedly prompted for authentication in Eclipse. + This is nuisance, but your usual credentials should apply in this case.</para> + </note> + </section> + + <section id="guvnor_repositories_view"> + <title>Guvnor Repositories View</title> + + <para>The <property>Guvnor Repositories view</property> contains tree structures for Guvnor + repository contents.</para> + + <figure> + <title>Guvnor Repositories View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/guvnor_repository.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>You can perform the following actions under the resources in the + <property>Guvnor Repositories view</property>:</para> + + <itemizedlist> + <listitem> + <para>create a new Guvnor repository connection. How to do this is describe above in the <link linkend="connection_wizard">&quot;Guvnor Connection Wizard&quot;</link> section.</para> + </listitem> + + <listitem> + <para>remove a Guvnor repository connection. Use the Delete button + ( <inlinemediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/delete_connection_button.png"/> + </imageobject> + </inlinemediaobject> ) in the tool-bar or the <emphasis> + <property>Delete</property></emphasis> option in the context menu to remove a repository connection.</para> + </listitem> + + <listitem> + <para>refresh Guvnor repository resorces. Use the <emphasis> + <property>Refresh</property></emphasis> context menu item to reload a tree content for the selected node.</para> + </listitem> + + <listitem> + <para>make use of &quot;drill-into&quot; functionality. It&apos;s represented by a number of tool-bar/context menu items such as <emphasis><property>Go Home</property></emphasis> + ( <inlinemediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/go_home_button.png"/> + </imageobject> + </inlinemediaobject> ), <emphasis><property>Go Back</property></emphasis> + ( <inlinemediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/go_back_button.png"/> + </imageobject> + </inlinemediaobject> ) and <emphasis> + <property>Go Into</property></emphasis> + ( <inlinemediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/go_into_button.png"/> + </imageobject> + </inlinemediaobject> ).</para> + </listitem> + </itemizedlist> + + <para>Drill-down is useful when working with deeply nested tree structures and when you wish to concentrate on only branch of the tree. For example, drilling into the <emphasis> + <property>&quot;defaultPackage&quot;</property></emphasis> node changes the tree view to:</para> + + <figure> + <title>Going Into the <emphasis>&quot;defaultPackage&quot;</emphasis></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/go_into_defaultPackage.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Clicking on the Go Home button ( <inlinemediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/go_home_button.png"/> + </imageobject> + </inlinemediaobject> ) or selecting <emphasis> + <property>Go Home</property></emphasis> in the context menu returns the tree to the top-level structure shown in the previous picture above. + </para> + + <para>There are a number of operations that can be performed on Guvnor repository files. Selecting a file in +the Guvnor repository causes the Eclipse <property>Properties view</property> to update with details about that file: +</para> + + <figure> + <title>Guvnor Repository Files Properties</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/repository_files_properties.png"/> + </imageobject> + </mediaobject> + </figure> + + <para></para> + </section> + + <section id="local_copies"> + <title>Local Copies of Guvnor Files</title> + + <para>As mentioned in the <link linkend="introduction">&quot;Introduction&quot;</link>, the main purpose + of the <property>EGT</property> is to allow development using resources held in a Guvnor + repository. There are two method of getting local copies of Guvnor repository + resources:</para> + + <orderedlist> + <listitem> + <para>Drag-and-drop from the <property>Guvnor Repositories view</property></para> + </listitem> + <listitem> + <para>Using the <link linkend="resources_from_guvnor">Import from Guvnor + wizard</link>, as described further in this document</para> + </listitem> + </orderedlist> + + <para>When local copies of Guvnor repository files are created, the <property>EGT</property> + sets an association between the local copy and the master file in the repository. This + information is kept in the (normally) hidden <emphasis> + <property>.guvnorinfo</property> + </emphasis> folder in the local project and, like all metadata, should not be changed by + end users.</para> + + <figure> + <title>.guvnorinfo metadata</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/guvnorinfo.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The association allows for operations such as update and commit in + synchronization with the master copy held in the Guvnor repository.</para> + + <para>The <property>EGT</property> decorates local resources associated with Guvnor + repository master copies. This decoration appears in Eclipse views conforming to the + Eclipse Common Navigator framework, such as the Eclipse <property>Resource + Navigator</property> and the Java <property>Package Explorer</property>. On the image + above you can see the <emphasis> + <property>Dummy rule.drl</property></emphasis> file with the decoration in the <property>Resource Navigator</property>. The Guvnor icon decorator is on the top right of the file image, and the Guvnor + revision details are appended to the file name. (The presence/location of these can be + changed the <link linkend="resource_decoration_preferences">Guvnor + Preferences</link>.)</para> + + <para>Here we see that, <emphasis><property>Dummy role.drl</property></emphasis> is associated with a Guvnor repository + resource and the local copy is based on revision 0, with a <code>02-10-2008, 4:21:53</code> date/time + stamp. The file <emphasis><property>Sample.drl</property>,</emphasis> however, is not associated with a Guvnor repository + file. Further details about the association can be found in the standard Eclipse + properties page, accessed via the <emphasis><property>Properties</property></emphasis> option in the context menu:</para> + + <figure> + <title>Association Details</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/association_details.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The <property>EGT</property> contributes a property page to the standard Eclipse + properties dialog, the contents of which are shown above. It displays the specific Guvnor + repository, the location within the repository, the version (date/time stamp) and + the revision number.</para> + </section> + + <section id="actions"> + <title>Actions for Local Guvnor Resources</title> + + <para>The <property>EGT</property> provides a number of actions (available through the + <emphasis><property>Guvnor</property></emphasis> context menu on files) for working with files, both those associated with + Guvnor repository master copies and those not associated. The actions are:</para> + + <itemizedlist> + <listitem> + <para> + <link linkend="update_action">Update</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="add_action">Add</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="commit_action">Commit</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="show_history_action">Show History</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="compare_with_version">Compare with Version</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="switch_to_version">Switch to Version</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="delete_action">Delete</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="disconnect_action">Disconnect</link> + </para> + </listitem> + </itemizedlist> + + <para>Each of these actions is described below.</para> + + <section id="update_action"> + <title>Update Action</title> + + <para>The <emphasis> + <property>Update</property> + </emphasis> action is available for one or more Guvnor resources that are not in + synchronization with the Guvnor repository master copies. These resources would not + be in synchronization because either/both</para> + + <orderedlist> + <listitem><para>There are local changes to these + resources</para></listitem> + <listitem><para>The master copies have been changed in the Guvnor repository</para></listitem> + </orderedlist> + + <para>Performing the <emphasis> + <property>Update</property> + </emphasis> action replaces the local file contents with the current contents from + the Guvnor repository master copies (equivalent to <emphasis> + <link linkend="switch_to_version">Switch to version</link> + </emphasis> for the latest version).</para> + </section> + + <section id="add_action"> + <title>Add Action</title> + + <para>The <emphasis> + <property>Add</property> + </emphasis> action is available for one or more local files that are not associated + with a Guvnor repository master copy. Choosing the <emphasis> + <property>Add</property> + </emphasis> action launches the <property>Add to Guvnor wizard</property>:</para> + + <figure> + <title>Add to Guvnor Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/add_toGuvnor_wizard.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The first page of the wizard asks for the selection of the target Guvnor + repository and gives the choice to create a new Guvnor repository connection (in + which case the second page is the same as the <link linkend="guvnor_connection_wizard" + >Guvnor Connection wizard</link>). Once the target Guvnor repository is chosen, + the wizard then asks for the folder location to add the selection files:</para> + + <figure> + <title>Selecting a Target Folder</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/select_target_folder.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Here the <emphasis> + <property>&quot;defaultPackage&quot;</property></emphasis> folder is selected as the destination + location.</para> + + <note> + <title>Note:</title> + <para>Note that the <emphasis> + <property>&quot;snapshot&quot;</property></emphasis> folder in the Guvnor repository is read-only for + <property>EGT</property>, and hence not visible as a candidate location in + this wizard. The Guvnor repository web administration tools must be used to add + snapshot content.</para> + </note> + + <para>Clicking on <emphasis> + <property>Finish</property> + </emphasis> adds the selected files to the Guvnor repository and creates an + association between the local and Guvnor repository files.</para> + + <note> + <title>Note:</title> + <para>Note that the wizard will not allow for overwrite of existing Guvnor + repository files. Another target location must be chosen.</para> + </note> + </section> + + <section id="commit_action"> + <title>Commit Action</title> + + <para>The <emphasis> + <property>Commit</property> + </emphasis> action is enabled for one or more Guvnor repository associated files + that have local changes. The <emphasis> + <property>Commit</property> + </emphasis> action will write the local changes back to the associated Guvnor + repository files and update the association for the new revision created.</para> + + <para>If a local change is based on an older revision of a file that is currently in the + Guvnor repository (for example, someone else changed the same file), then the <emphasis> + <property>Commit</property> + </emphasis> action will<figure> + <title>Add to Guvnor Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/add_toGuvnor_wizard.png"/> + </imageobject> + </mediaobject> + </figure> ask whether you wish to overwrite the current version in the + Guvnor repository with the local content. When such conflicts occur, however, you + should use the Eclipse Guvnor version tools, along with Eclipse standard tools, to + determine the differences and merge content based on the current version in the + Guvnor repository.</para> + </section> + + <section id="show_history_action"> + <title>Show History Action</title> + + <para>The <emphasis> + <property>Show History</property> + </emphasis> action is enable for one Guvnor repository associated file and causes + the <link linkend="guvnor_history_view">Guvnor Resource History view</link> to be + populated with revision history for the selected file.</para> + </section> + + <section id="compare_with_version"> + <title>Compare with Version Action</title> + + <para>The <emphasis> + <property>Compare with Version</property> + </emphasis> action is enabled for one Guvnor repository associated file. This action + first opens a wizard asking for the version for comparison (with the local file + contents):</para> + + <figure> + <title>Compare with Version Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/compare_with_version.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Once the revision is selected, the action opens the Eclipse <property>Compare + editor</property> (read-only):</para> + <figure> + <title>Eclipse Compare Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/compare_with_version2.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>This editor uses Eclipse-standard comparison techniques to show the differences in + the two versions. In cases where there are no differences, the editor will not open, + rather a dialog saying that there are no differences will appear.</para> + <figure> + <title>Alert Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/compare_with_version3.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="switch_to_version"> + <title>Switch to Version Action</title> + + <para>The <emphasis> + <property>Switch to Version</property> + </emphasis> action is enabled for one Guvnor repository associated file.</para> + <para>First the <emphasis> + <property>Switch to Version</property> + </emphasis> action prompts for selection of version:</para> + + <figure> + <title>Select Version Window</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/compare_with_version.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Once the version is selected, the <emphasis> + <property>Switch to Version</property> + </emphasis> action replaces the local file contents with those from the revision + selected.</para> + </section> + + <section id="delete_action"> + <title>Delete Action</title> + + <para>The <emphasis> + <property>Delete</property> + </emphasis> action is enabled for one or more Guvnor repository associated files. + After confirmation via a dialog, the <emphasis> + <property>Delete</property> + </emphasis> action removes the files in the Guvnor repository and deletes local + metadata for the Guvnor repository association.</para> + + <figure> + <title>Comfirm Delete Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/confirm_delete.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="disconnect_action"> + <title>Disconnect Action</title> + + <para>The <emphasis> + <property>Disconnect</property> + </emphasis> action is enabled for one or more Guvnor repository associated files, + and removes local metadata for the Guvnor repository association.</para> + </section> + </section> + + <section id="guvnor_history_view"> + <title>Guvnor Resource History View</title> + + <para>The <property>Guvnor Resource History view</property> should details about revision + history for selected files, both local and those in Guvnor repositories. The initial + state of this view is shown on the figure below.</para> + + <figure> + <title>Initial State of the Guvnor Resource History View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/resource_history_view.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The <property>Guvnor Resource History view</property> is populated by <emphasis> + <property>Show History</property> + </emphasis> actions in either the local <emphasis> + <property>Guvnor</property></emphasis> context menu or in the context menu for + a Guvnor repository file in the <link linkend="guvnor_repositories_view">Guvnor + Repositories view</link>. Once this action is performed, the <property>Guvnor + Resource History view</property> updates to show the revision history:</para> + + <figure> + <title>IGuvnor Resource History View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/resource_history_view2.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Here we see that the file <emphasis> + <property>test.txt</property> + </emphasis> has three revisions. Double clicking on a revision row (or the context menu <emphasis> + <property>Open (Read only)</property>)</emphasis> opens an Eclipse read-only editor + with the revision contents.</para> + + <figure> + <title>Eclipse Read-only Editor with the Revision Contents</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/resource_history_view3.png"/> + </imageobject> + </mediaobject> + </figure> + <note> + <title>Note:</title> + <para>You can also use the <emphasis> + <property>Save As...</property> + </emphasis> option when a file is open in a read-only editor to save a local + writable copy of the contents. Doing so, however, will not associate the file + created with its Guvnor source.</para> + </note> + + </section> + + <section id="resources_from_guvnor"> + <title>Importing Guvnor Repository Resources</title> + + <para>In addition to the single file drag-and-drop from the <property>Guvnor Repositories + view</property>, the <property>EGT</property> also includes a wizard for copying one + or more files from a Guvnor repository to the local workspace (and setting the + association with the Guvnor repository). This wizard is available from the <emphasis> + <property>File &gt; Import &gt; Guvnor &gt; Resource from + Guvnor</property> + </emphasis> and the <emphasis> + <property>File &gt; New &gt; Other &gt; Guvnor &gt; Resource from + Guvnor</property> + </emphasis> menu items.</para> + <note> + <title>Note:</title> + + <para>Note that the wizard is identical but appears in both locations to accommodate + users who tend to view this functionality as being in either category.</para> + </note> + + <para>The first page of the wizard asks for the selection of the source Guvnor repository + and gives the choice to create a new Guvnor repository connection (in which case the + second page is the same as the <link linkend="guvnor_connection_wizard">Guvnor Connection wizard</link>).</para> + + <figure> + <title>Resource from Guvnor Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/add_toGuvnor_wizard.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Once the source Guvnor repository is chosen, the wizard prompts for resource selection:</para> + + <figure> + <title>Resource Selection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/resource_from_guvnor.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Finally, the target location in the local workspace should be chosen:</para> + <figure> + <title>Choosing the Target Location</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/resource_from_guvnor2.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>On completion the wizard copies the selected files from the Guvnor repository to the local workspace. + If a file with the same name already exists in the destination, the wizard uses the Eclipse standard + &quot;prompt for rename&quot; dialog:</para> + + <figure> + <title>Prompt for Rename Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/functionality_overview/resource_from_guvnor3.png"/> + </imageobject> + </mediaobject> + </figure> + </section> +</chapter> Added: trunk/drools/docs/guvnor_ref/en/modules/guvnor_preferences.xml =================================================================== --- trunk/drools/docs/guvnor_ref/en/modules/guvnor_preferences.xml (rev 0) +++ trunk/drools/docs/guvnor_ref/en/modules/guvnor_preferences.xml 2009-05-12 12:50:47 UTC (rev 15227) @@ -0,0 +1,90 @@ +<?xml version='1.0' encoding='UTF-8'?> +<chapter id="guvnor_preferences" xreflabel="guvnor_preferences"> + <?dbhtml filename="guvnor_preferences.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Eclipse Guvnor Tools</keyword> + </keywordset> + </chapterinfo> + + <title>Guvnor Preferences</title> + + <para>The <property>EGT</property> provides a preference page in the <emphasis> + <property>Guvnor</property> + </emphasis> category:</para> + + <figure> + <title>Resource Selection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/guvnor_preferences/guvnor_preferences.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>The preferences cover two categories:</para> + <itemizedlist> + <listitem><para>Guvnor repository connections</para></listitem> + + <listitem><para>Local Guvnor + repository resource decorations.</para></listitem> + </itemizedlist> + + <section id="repo_connection_preferences"> + <title>Guvnor Repository Connection Preferences</title> + <para>There are two preferences that can be set for Guvnor repository connections, that are + used when creating new connections:</para> + + <itemizedlist> + <listitem> + <para>The first is a default Guvnor repository URL template, which can make it + easier to create multiple similar connections by simply changing part of the + field, such as the host name.</para> + </listitem> + <listitem> + <para>The second is whether saving of authentication information in the Eclipse + platform key-ring should be enabled by default.</para> + </listitem> + </itemizedlist> + + <para>As with the Guvnor repository URL template, actually whether to save a specific + instance of authentication information in the Eclipse platform key-ring can be + determined when actually creating the connection. That is, both of these preferences are + simply convenience values set to reasonable defaults.</para> + </section> + + <section id="resource_decoration_preferences"> + <title>Local Guvnor Repository Resource Decoration Preferences</title> + + <para>The second category of preferences provided by the <property>EGT</property> deals with how the decoration of + local resources associated with Guvnor repository resources is presented. Since the + Guvnor repository is not a substitute for a SCM, and since SCM tools in Eclipse tend to + decorate local resources, it is useful to be able to control just how the <property>EGT</property> decorate + its local resources to avoid messy conflicts with SCM packages.</para> + + <para>In the <emphasis> + <property>File Decoration</property></emphasis> + section of the preference page, you can choose the location (Top right, Top left, Bottom right, + Bottom left) of the decoration icon, or you can choose not to display it. In + the <emphasis> + <property>Text</property></emphasis> section, you can format the Guvnor metadata that is appended to the file + names:</para> + <itemizedlist> + <listitem> + <para>Whether to show an indicator (&gt;) when the local file has changes not committed back to the + Guvnor repository</para> + </listitem> + <listitem> + <para>Whether to show the revision number</para> + </listitem> + <listitem> + <para>Whether to show the date/time stamp</para> + </listitem> + </itemizedlist> + + <para>Any changes to these preferences take effect immediately upon clicking the <emphasis> + <property>Apply</property></emphasis> and then <emphasis> + <property>Ok</property></emphasis> buttons.</para> + </section> +</chapter> Added: trunk/drools/docs/guvnor_ref/en/modules/introduction.xml =================================================================== --- trunk/drools/docs/guvnor_ref/en/modules/introduction.xml (rev 0) +++ trunk/drools/docs/guvnor_ref/en/modules/introduction.xml 2009-05-12 12:50:47 UTC (rev 15227) @@ -0,0 +1,179 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<chapter id="introduction" xreflabel="introduction"> + <title>Introduction</title> + + <para>The purpose of this document is to describe briefly the functionality present in the + <property>Eclipse Guvnor Tools</property> (EGT) for Drools 5. While not intended as a + comprehensive reference, there should be enough detail included for early adopters using + these tools.</para> + + <para>The <property>Guvnor repository</property> is not intended as a Source Code Management + (SCM) solution, and the <property>EGT</property> are not intended to be Eclipse “team + provider” extensions or replacements. Rather, the Guvnor repository is a location where + certain artifacts (such as rules and SOA policy definitions) are controlled (“governed”) by + policies defined by the deployment environment. The purpose of the <property>EGT</property> + is then to enable access to resources held by the Guvnor repository, so + they can be used in development. Thus, limited capabilities for reading, writing, adding, + and removing Guvnor repository resources are provided in the + <property>EGT</property>.</para> + + <section id="drools_key_features"> + <title>Guvnor Tools Key Features</title> + + <para>The following table lists all valuable features of the <property>Guvnor + Tools</property>.</para> + <table> + <title>Key Functionality of Guvnor Tools</title> + <tgroup cols="3"> + + <colspec colnum="1" align="left" colwidth="1*"/> + <colspec colnum="2" colwidth="5*"/> + <colspec colnum="3" align="left" colwidth="1*"/> + + <thead> + <row> + <entry>Feature</entry> + <entry>Benefit</entry> + <entry>Chapter</entry> + </row> + </thead> + + <tbody> + + <row> + <entry> + <para>Guvnor Repositories View</para> + </entry> + <entry> + <para>The purpose of the view is to enable access to Guvnor repository + resources in a standard tree format</para> + </entry> + <entry> + <link linkend="guvnor_repositories_view">Guvnor Repositories View</link> + </entry> + </row> + + <row> + <entry> + <para>Guvnor Connection Wizard</para> + </entry> + <entry> + <para>The wizard helps to create a connection to a Guvnor + repository.</para> + </entry> + <entry> + <link linkend="connection_wizard">Guvnor Connection Wizard</link> + </entry> + </row> + + <row> + <entry> + <para>Guvnor Resource History View</para> + </entry> + <entry> + <para>This view shows revisions of specific resources available in the + repository.</para> + </entry> + <entry> + <link linkend="guvnor_history_view">Guvnor Resource History View</link> + </entry> + </row> + + <row> + <entry> + <para>Resources from Guvnor Wizard</para> + </entry> + <entry> + <para>The wizard helps to get local copies of Guvnor repository + resources.</para> + </entry> + <entry> + <link linkend="resources_from_guvnor">Importing Guvnor Repository + Resources</link> + </entry> + </row> + + <row> + <entry> + <para>A number of actions for working with files</para> + </entry> + <entry> + <para>The Guvnor actions (available through the <emphasis> + <property>Guvnor</property> + </emphasis> context menu on files) are provided for working with + files, both those associated with Guvnor repository master copies + and those not associated.</para> + </entry> + <entry> + <link linkend="actions">Actions for Local Guvnor Resources</link> + </entry> + </row> + + </tbody> + </tgroup> + </table> + </section> + + <section id="how_to_start"> + <title>How to start with Guvnor Tools</title> + + <para><property>Guvnor Tools</property> is a part of the <property>JBoss Tools</property> + project. Thus to get started with <property>Guvnor Tools</property>, you should have the following:</para> + + <itemizedlist> + <listitem> + <para>Eclipse 3.4.x with Jboss Tools bundle of Eclipse plugins installed. How to + install JBoss Tools onto Eclipse you can find in the <ulink + url="&gsglink;#JBossToolsInstall">&quot;JBoss Tools + Installation&quot;</ulink> section.</para> + </listitem> + + <listitem> + <para>JBoss Server 4.2 or higher with Guvnor repository deployed. Thus, you should + download <ulink + url="http://download.jboss.org/drools/release/5.0.0.25561.CR1/drools... + >Guvnor CR1</ulink> and extract it to the deploy directory of the + server.</para> + </listitem> + </itemizedlist> + + <para>Now refer to the <link linkend="functionality_overview">&quot;Functionality + Overview&quot;</link> section to find out what you can do with Guvnor and + Eclipse synchronisation tool.</para> + </section> + + <section> + <title>Other relevant resources on the topic</title> + + <itemizedlist> + <listitem> + <para>Guvnor <ulink url="http://www.jboss.org/community/wiki/Guvnor">wiki page</ulink></para> + </listitem> + + <listitem> + <para>Drools on <ulink url="http://www.jboss.org/drools/">JBoss.org</ulink>&l... + </listitem> + + <listitem> + <para> + <ulink url="http://www.jboss.org/tools/">JBoss Tools Home Page</ulink> + </para> + </listitem> + + <listitem> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">The latest + JBossTools/JBDS documentation builds</ulink> + </para> + </listitem> + + <listitem> + <para> + <ulink url="http://docs.jboss.org/tools/">JBossTools/JBDS + release documentation</ulink></para> + </listitem> + </itemizedlist> + + </section> +</chapter> Added: trunk/drools/docs/guvnor_ref/pom.xml =================================================================== --- trunk/drools/docs/guvnor_ref/pom.xml (rev 0) +++ trunk/drools/docs/guvnor_ref/pom.xml 2009-05-12 12:50:47 UTC (rev 15227) @@ -0,0 +1,107 @@ +<project xmlns="http://maven.apache.org/POM/4.0.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + + <modelVersion>4.0.0</modelVersion> + + <groupId>org.jboss.tools</groupId> + <artifactId>guvnor-tools-ref-guide-${translation}</artifactId> + <version>1.0-SNAPSHOT</version> + <packaging>jdocbook</packaging> + <name>Guvnor_Tools_Reference_Guide</name> + + <build> + <plugins> + <plugin> + <groupId>org.jboss.maven.plugins</groupId> + <artifactId>maven-jdocbook-plugin</artifactId> + <version>2.1.0-200803311251UTC-MPJDOCBOOK-8</version> + + <extensions>true</extensions> + + <dependencies> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-docbook-xslt</artifactId> + <version>1.1.0</version> + </dependency> + <dependency> + <groupId>org.jboss</groupId> + <artifactId>jbossorg-jdocbook-style</artifactId> + <version>1.1.0</version> + <type>jdocbook-style</type> + </dependency> + </dependencies> + + <configuration> + <sourceDocumentName>master.xml</sourceDocumentName> + <sourceDirectory>${pom.basedir}/en</sourceDirectory> + <imageResource> + <directory>${pom.basedir}/en</directory> + <includes> + <include>images/**/*</include> + </includes> + </imageResource> + <cssResource> + <directory>${pom.basedir}/${cssdir}</directory> + </cssResource> + + <formats> + <format> + <formatName>pdf</formatName> + <stylesheetResource>file:${pom.basedir}/${stylesdir}/xslt/org/jboss/tools/pdf.xsl</stylesheetResource> + <finalName>${pom.name}.pdf</finalName> + </format> + <format> + <formatName>html</formatName> + <stylesheetResource>file:${pom.basedir}/${stylesdir}/xslt/org/jboss/tools/xhtml.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>html_single</formatName> + <stylesheetResource>file:${pom.basedir}/${stylesdir}/xslt/org/jboss/tools/xhtml-single.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + <format> + <formatName>eclipse</formatName> + <stylesheetResource>file:${pom.basedir}/${stylesdir}/xslt/org/jboss/tools/eclipse.xsl</stylesheetResource> + <finalName>index.html</finalName> + </format> + </formats> + + <options> + <xincludeSupported>true</xincludeSupported> + <xmlTransformerType>saxon</xmlTransformerType> + <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme --> + <!-- could also locate the docbook dependency and inspect its version... --> + <docbookVersion>1.72.0</docbookVersion> + </options> + + </configuration> + </plugin> + + </plugins> + </build> + + <distributionManagement> + <repository> + <!-- Copy the dist to the local checkout of the JBoss maven2 repo ${maven.repository.root} --> + <!-- It is anticipated that ${maven.repository.root} be set in user's settings.xml --> + <!-- todo : replace this with direct svn access once the svnkit providers are available --> + <id>repository.jboss.org</id> + <url>file://${maven.repository.root}</url> + </repository> + <snapshotRepository> + <id>snapshots.jboss.org</id> + <name>JBoss Snapshot Repository</name> + <url>dav:https://snapshots.jboss.org/maven2</url> + </snapshotRepository> + </distributionManagement> + + <properties> + <stylesdir>../../../documentation/jbosstools-docbook-xslt/src/main/resources/</stylesdir> + <cssdir>../../../documentation/jbosstools-jdocbook-style/src/main/org/css/</cssdir> + <translation>en-US</translation> + </properties> + +</project>