Author: mmcallis
Date: 2008-03-26 03:13:12 -0400 (Wed, 26 Mar 2008)
New Revision: 10377
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
Log:
6.2.1. *-object.xml Files
- revising introduction paragraph
- moved admonition to end of section
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml
===================================================================
---
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml 2008-03-26
06:32:02 UTC (rev 10376)
+++
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/configuration.xml 2008-03-26
07:13:12 UTC (rev 10377)
@@ -124,6 +124,7 @@
</para>
<para>
<note>
+ <title>Changing the context-root</title>
<para>
By default, Tomcat holds on to the root context,
<emphasis>/</emphasis>. You may need to remove the
<filename>$JBOSS_HOME/server/default/deploy/jboss-web.deployer/ROOT.war/</filename>
directory,
or add a <filename>jboss-web.xml</filename> file, which declares
another
Modified:
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml
===================================================================
---
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-26
06:32:02 UTC (rev 10376)
+++
docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-26
07:13:12 UTC (rev 10377)
@@ -973,27 +973,15 @@
</sect1>
<sect1 id="descriptors_portlet">
<title>Portlet Descriptors</title>
- <para>To define your portal objects (portals, pages, portlet instances,
windows, and portlets), you will be using
- the descriptors found in this section. This section seeks to describe these
descriptors. It is recommended you
- also look at
- <xref linkend="tutorials_tutorials"/>
- and
- <xref linkend="desc_examples"/>
- for samples on how they are used within a portlet application.
+ <para>
+ The following sections describe the descriptors used to define portal objects,
such as portals, pages, portlet instances, windows, and portlets. Refer to <xref
linkend="tutorials_tutorials"/> and <xref
linkend="desc_examples"/> for examples on using these descriptors within a
portlet application.
</para>
<sect2 id="desc_objectxml">
- <title>*-object.xml</title>
+ <title><filename>*-object.xml</filename> Files</title>
<para>
- The *-object.xml file is used to define: portal instances, pages, windows,
window layout. Additionally,
- you can also specify the themes and layouts used for specific portal
instances, pages, and windows. The
- description below, only defines a portlet window being added to the default
page in the default portal. For
- advanced functionality, using this descriptor, please read <xref
linkend="desc_examples"/>.
-
- <note>
- <emphasis>Is this descriptor mandatory?</emphasis>
- Technically, no, as you can define your portal object hierarchy (create
portals, pages, instances and
- organize them as you see fit) from the management portlet accessible to
Portal administrators.
- </note>
+ The <filename>*-object.xml</filename> files are used to define
portal instances, pages, windows, and the window layout. As well, themes and layouts for
specific portal instances, pages, and windows, can be defined. The following example
defines a portlet window being added to the default page, in the default portal. For
advanced functionality using this descriptor, refer to <xref
linkend="desc_examples"/>:
+ </para>
+ <para>
<programlisting><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE deployments PUBLIC
@@ -1101,6 +1089,15 @@
</imageobject>
</mediaobject>
</para>
+
+ <para>
+ <note>
+ <title>Are <filename>*-object.xml</filename> descriptors
necessary?</title>
+ <para>
+ Technically, they are not. The portal object hierarchy, such as creating portals,
pages, instances, and organizing them on the page, can be defined using the management
portlet, which is accessible to JBoss Portal administrators.
+ </para>
+ </note>
+ </para>
</sect2>
<sect2 id="desc_instancesxml">
<title>portlet-instances.xml</title>