Improve org.eclipse.ui.menus extension point documentation

Fixes a typo and improves formatting in locationURI documentation for
menuContribution elements.

Author: HeikoKlare

bundles/org.eclipse.ui/schema/menus.exsd

@@ -527,12 +527,14 @@ This should be the starting point for <i>all</i> contributions into
                   A <code>URI</code> specification that defines the insertion point at which the contained additions will be added.
 
 The format for the URI is comprised of three basic parts:
-
-Scheme: One of "menu", "popup" or "toolbar. Indicates the type of the manager used to handle the contributions
-Id: This is either the id of an existing menu, a view id or the id of the editor 'type'
-Query: The query format is <placement>=<id> where:
- <placement> is either "before", "after", or "endof" and
- <id> is the id of an existing menu item.  The placement modifier is executed when this contribution is processed.  Following contributions may change the final shape of the menu when they are processed.
+<ul>
+   <li>Scheme: One of "menu", "popup" or "toolbar". Indicates the type of the manager used to handle the contributions</li>
+   <li>Id: This is either the id of an existing menu, a view id or the id of the editor 'type'</li>
+   <li>Query: The query format is <placement>=<id> where <placement> is either "before", "after", or "endof" and <id> is the id of an existing menu item.</li>
+ </ul>
+ <p>
+The placement modifier is executed when this contribution is processed. Following contributions may change the final shape of the menu when they are processed.
+</p>
                </documentation>
             </annotation>
          </attribute>
@@ -917,22 +919,6 @@ If defined then it can be  used as a reference in the Query part of the location
       </complexType>
    </element>
 
-   <annotation>
-      <appInfo>
-         <meta.section type="apiInfo"/>
-      </appInfo>
-      <documentation>
-         &lt;p&gt;
-It is preferred that menu contributions be added in the &lt;code&gt;plugin.xml&lt;/code&gt;.  Plugins can
-programmatically add their own menu contributions using &lt;code&gt;org.eclipse.ui.menus.IMenuService&lt;/code&gt; and &lt;code&gt;org.eclipse.ui.menus.AbstractContributionFactory&lt;/code&gt;, but should be sure to remove them if the plugin is unloaded.  The &lt;code&gt;IMenuService&lt;/code&gt; can be retrieved through any of the &lt;code&gt;IServiceLocators&lt;/code&gt;, the workbench, the workbench window, or the part site.
-&lt;/p&gt;
-&lt;p&gt;
-See &lt;a href=&quot;org_eclipse_ui_commands.html&quot;&gt;org.eclipse.ui.commands&lt;/a&gt; to define a command and &lt;a href=&quot;org_eclipse_ui_handlers.html&quot;&gt;org.eclipse.ui.handlers&lt;/a&gt; to define an implementation for the command.
-&lt;/p&gt;
-&lt;p&gt;To register a context menu, use the &lt;code&gt;IWorkbenchPartSite.registerContextMenu&lt;/code&gt; methods.&lt;/p&gt;
-      </documentation>
-   </annotation>
-
    <annotation>
       <appInfo>
          <meta.section type="since"/>
@@ -972,6 +958,22 @@ This is the simplest example; adding a command contribution after an existing me
       </documentation>
    </annotation>
 
+   <annotation>
+      <appInfo>
+         <meta.section type="apiInfo"/>
+      </appInfo>
+      <documentation>
+         &lt;p&gt;
+It is preferred that menu contributions be added in the &lt;code&gt;plugin.xml&lt;/code&gt;.  Plugins can
+programmatically add their own menu contributions using &lt;code&gt;org.eclipse.ui.menus.IMenuService&lt;/code&gt; and &lt;code&gt;org.eclipse.ui.menus.AbstractContributionFactory&lt;/code&gt;, but should be sure to remove them if the plugin is unloaded.  The &lt;code&gt;IMenuService&lt;/code&gt; can be retrieved through any of the &lt;code&gt;IServiceLocators&lt;/code&gt;, the workbench, the workbench window, or the part site.
+&lt;/p&gt;
+&lt;p&gt;
+See &lt;a href=&quot;org_eclipse_ui_commands.html&quot;&gt;org.eclipse.ui.commands&lt;/a&gt; to define a command and &lt;a href=&quot;org_eclipse_ui_handlers.html&quot;&gt;org.eclipse.ui.handlers&lt;/a&gt; to define an implementation for the command.
+&lt;/p&gt;
+&lt;p&gt;To register a context menu, use the &lt;code&gt;IWorkbenchPartSite.registerContextMenu&lt;/code&gt; methods.&lt;/p&gt;
+      </documentation>
+   </annotation>
+
 
    <annotation>
       <appInfo>