Author: mmcallis Date: 2008-03-28 02:03:03 -0400 (Fri, 28 Mar 2008) New Revision: 10394 Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml Log: 6.2.1. *-object.xml Descriptors - revising - trying to make text consistent across chapters (5.2.1.4. Application Descriptors) Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml =================================================================== --- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-03-27 17:36:08 UTC (rev 10393) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/tutorials.xml 2008-03-28 06:03:03 UTC (rev 10394) @@ -436,7 +436,7 @@ </screen></term> <listitem> <para> - This can be named anything. + A <emphasis role="bold">unique name</emphasis> given to the portlet window. This can be named anything. </para> </listitem> </varlistentry> @@ -456,7 +456,7 @@ </screen></term> <listitem> <para> - Specifies the layout region, and the order this window will be found on the portal page. + Specifies where the window will appear within the page layout. </para> </listitem> </varlistentry> 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-27 17:36:08 UTC (rev 10393) +++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/xmldescriptors.xml 2008-03-28 06:03:03 UTC (rev 10394) @@ -738,7 +738,7 @@ </screen> </para> <para> - Define the content of the window as a reference to a portlet instance. This value is the ID of the instance, and must much the value of one of the <computeroutput>&lt;instance-id&gt;</computeroutput> elements in the <filename>WEB-INF/portlet-instances.xml</filename> file. The following is an example of the <computeroutput>&lt;instance-ref&gt;</computeroutput> element: + Define the content of the window as a reference to a portlet instance. This value is the ID of a portlet instance, and must much the value of one of the <computeroutput>&lt;instance-id&gt;</computeroutput> elements in the <filename>WEB-INF/portlet-instances.xml</filename> file. The following is an example of the <computeroutput>&lt;instance-ref&gt;</computeroutput> element: </para> <para> <screen> @@ -1036,35 +1036,35 @@ <listitem> <para> <programlisting><![CDATA[<window>...</window>]]></programlisting> - Used to define a portlet window. You will then need to assign to this window, a portlet instance - and assign it to a layout region. + </para> + <para> + Used to define a portlet window. The <computeroutput>&lt;window&gt;</computeroutput> element requires an <computeroutput>&lt;instance-ref&gt;</computeroutput> element, which is used to assign the window a portal instance. As well, use the <computeroutput>&lt;region&gt;</computeroutput> and <computeroutput>&lt;height&gt;</computeroutput> elements to define where the window will appear in the portlet. </para> </listitem> <listitem> <para> <programlisting><![CDATA[<window-name>...</window-name>]]></programlisting> - A - <emphasis role="bold">unique name</emphasis> - given to this portlet window. + </para> + <para> + A <emphasis role="bold">unique name</emphasis> given to the portlet window. This can be named anything. </para> </listitem> <listitem> <para> <programlisting><![CDATA[<instance-ref>...</instance-ref>]]></programlisting> - The portlet instance that this window will represent. It must correspond to the value of - <emphasis>instance-id</emphasis> - , assigned in your - <emphasis>portlet-instances.xml</emphasis> - </para> + </para> + <para> + The portlet instance that the window will represent. This value is the ID of a portlet instance, and must match the value of one of the <computeroutput>&lt;instance-id&gt;</computeroutput> elements in the <filename>WEB-INF/portlet-instances.xml</filename> file. + </para> </listitem> <listitem> <para> - <programlisting><![CDATA[<region>...</region><height>...</height>]]></programlisting> - The values are used to specify where this window will appear within the page layout. - <emphasis>Region</emphasis> - often depends on regions defined in your layout. - <emphasis>Height</emphasis> - can be any number between 0-X. +<programlisting><![CDATA[ +<region>...</region> +<height>...</height>]]></programlisting> + </para> + <para> + Specifies where the window will appear within the page layout. The <computeroutput>&lt;region&gt;</computeroutput> element specifies where the window will appear on the page. The <computeroutput>&lt;region&gt;</computeroutput> element often depends on other regions defined in your layout. The <computeroutput>&lt;height&gt;</computeroutput> element can be assigned a value between one and <replaceable>X</replaceable>. </para> </listitem> </itemizedlist>