[jboss-svn-commits] JBL Code SVN: r34139 - in labs/jbossrules/trunk/drools-docs: drools-docs-expert/src/main/docbook/en-US/Chapter-Examples and 3 other directories.

[jboss-svn-commits at lists.jboss.org]

Author: ge0ffrey
Date: 2010-07-23 10:33:58 -0400 (Fri, 23 Jul 2010)
New Revision: 34139

Modified:
   labs/jbossrules/trunk/drools-docs/doc-authoring-guideline-and-cheatsheet.txt
   labs/jbossrules/trunk/drools-docs/drools-docs-expert/src/main/docbook/en-US/Chapter-Examples/Section-InsuranceExample.xml
   labs/jbossrules/trunk/drools-docs/drools-docs-guvnor/src/main/docbook/en-US/Chapter-Guvnor/Section-Architecture.xml
   labs/jbossrules/trunk/drools-docs/drools-docs-introduction/src/main/docbook/en-US/Chapter-Install/Section-Maven_build.xml
   labs/jbossrules/trunk/drools-docs/drools-docs-planner/src/main/docbook/en-US/Chapter-Use_cases_and_examples/Chapter-Use_cases_and_examples.xml
Log:
docs: use of <command>

Modified: labs/jbossrules/trunk/drools-docs/doc-authoring-guideline-and-cheatsheet.txt
===================================================================
--- labs/jbossrules/trunk/drools-docs/doc-authoring-guideline-and-cheatsheet.txt	2010-07-23 14:29:04 UTC (rev 34138)
+++ labs/jbossrules/trunk/drools-docs/doc-authoring-guideline-and-cheatsheet.txt	2010-07-23 14:33:58 UTC (rev 34139)
@@ -43,7 +43,7 @@
 
 * <warning><para></para></warning>
 
-* Use <programlisting> for code listings:
+* Use <programlisting> for longer code, commands or log listings:
     <programlisting><![CDATA[public interface Move ...]]></programlisting>
 
 * Use <programlisting role="JAVA"> for java code to get color highlighting.

Modified: labs/jbossrules/trunk/drools-docs/drools-docs-expert/src/main/docbook/en-US/Chapter-Examples/Section-InsuranceExample.xml
===================================================================
--- labs/jbossrules/trunk/drools-docs/drools-docs-expert/src/main/docbook/en-US/Chapter-Examples/Section-InsuranceExample.xml	2010-07-23 14:29:04 UTC (rev 34138)
+++ labs/jbossrules/trunk/drools-docs/drools-docs-expert/src/main/docbook/en-US/Chapter-Examples/Section-InsuranceExample.xml	2010-07-23 14:33:58 UTC (rev 34139)
@@ -154,7 +154,7 @@
 	
 			<itemizedlist>
 				<listitem>
-					<para>Go into your downloaded project and execute <programlisting>mvn clean package</programlisting></para>
+					<para>Go into your downloaded project and execute <command>mvn clean package</command></para>
 				</listitem>
 	
 				<listitem>

Modified: labs/jbossrules/trunk/drools-docs/drools-docs-guvnor/src/main/docbook/en-US/Chapter-Guvnor/Section-Architecture.xml
===================================================================
--- labs/jbossrules/trunk/drools-docs/drools-docs-guvnor/src/main/docbook/en-US/Chapter-Guvnor/Section-Architecture.xml	2010-07-23 14:29:04 UTC (rev 34138)
+++ labs/jbossrules/trunk/drools-docs/drools-docs-guvnor/src/main/docbook/en-US/Chapter-Guvnor/Section-Architecture.xml	2010-07-23 14:33:58 UTC (rev 34139)
@@ -63,13 +63,13 @@
       of the main drools build.</para>
 
       <para>Initially, go into the root of the jboss-rules checked out source
-      tree, and run mvn install to install all the components for the inter
+      tree, and run <command>mvn install</command> to install all the components for the inter
       project dependencies. If the build is broken (all care is taken for this
       eventuality not to occur), the flag -Dmaven.test.skip=true can be used
       to prevent failing unit tests from preventing the build.</para>
 
       <para>When wishing to build Guvnor, go into the drools-guvnor
-      directory, and run <code>mvn package</code>. This will run the tests,
+      directory, and run <command>mvn package</command>. This will run the tests,
       and then build a deployable war. The only thing this will not do is
       rebuild the GWT front end (see the next section for details on that).
       Once the war file is in the target directory, the BRMS is ready to

Modified: labs/jbossrules/trunk/drools-docs/drools-docs-introduction/src/main/docbook/en-US/Chapter-Install/Section-Maven_build.xml
===================================================================
--- labs/jbossrules/trunk/drools-docs/drools-docs-introduction/src/main/docbook/en-US/Chapter-Install/Section-Maven_build.xml	2010-07-23 14:29:04 UTC (rev 34138)
+++ labs/jbossrules/trunk/drools-docs/drools-docs-introduction/src/main/docbook/en-US/Chapter-Install/Section-Maven_build.xml	2010-07-23 14:33:58 UTC (rev 34139)
@@ -21,13 +21,13 @@
     following builds all the jars, the documentation and the Eclipse zip with
     a local folder specified to avoid downloading Eclipse:</para>
 
-    <para><programlisting>mvn -Declipse -Ddocumentation clean install -DlocalEclipseDrop=/folder/jboss-drools/local-Eclipse-drop-mirror </programlisting></para>
+    <programlisting>mvn -Declipse -Ddocumentation clean install -DlocalEclipseDrop=/folder/jboss-drools/local-Eclipse-drop-mirror</programlisting>
 
     <para>You can produce distribution builds, which puts everything into
-    zips, as follows:
+    zips, as follows:</para>
 <programlisting>mvn -Declipse -Ddocumentation clean install -DlocalEclipseDrop=/folder/jboss-drools/local-Eclipse-drop-mirror
 mvn -Ddocumentation -Declipse -Dmaven.test.skip package javadoc:javadoc assembly:assembly -DlocalEclipseDrop=/folder/jboss-drools/local-Eclipse-drop-mirror
-</programlisting></para>
+</programlisting>
 
     <para>Note that install must be done first as javadoc:javadoc won't work
     unless the jars are in the local maven repo, but the tests can be skipped
@@ -35,7 +35,7 @@
     available memory to Maven, on windows the following command worked well:
     set MAVEN_OPTS=-Xmx512m</para>
 
-    <para>Type mvn clean to clear old artifacts, and then test and built the
+    <para>Type <command>mvn clean</command> to clear old artifacts, and then test and built the
     source, and report on any errors.</para>
 
     <para>The resulting jars are put in the /target directory from the top

Modified: labs/jbossrules/trunk/drools-docs/drools-docs-planner/src/main/docbook/en-US/Chapter-Use_cases_and_examples/Chapter-Use_cases_and_examples.xml
===================================================================
--- labs/jbossrules/trunk/drools-docs/drools-docs-planner/src/main/docbook/en-US/Chapter-Use_cases_and_examples/Chapter-Use_cases_and_examples.xml	2010-07-23 14:29:04 UTC (rev 34138)
+++ labs/jbossrules/trunk/drools-docs/drools-docs-planner/src/main/docbook/en-US/Chapter-Use_cases_and_examples/Chapter-Use_cases_and_examples.xml	2010-07-23 14:33:58 UTC (rev 34139)
@@ -14,7 +14,7 @@
     examples are recommended: curriculum course, examination and nurse rostering.</para>
 
     <para>You can find the source code of all these examples in the drools source distribution and also in subversion
-    under <literal>drools-planner/drools-planner-examples</literal>.</para>
+    under <filename>drools-planner/drools-planner-examples</filename>.</para>
   </section>
 
   <section>