updates made during my review of beans.xml:

* eliminated all usage of "the section entitled", because <xref> links already render including "the section called ".  This was resulting in sentences like 'see also the section entitled the section called "@Autowired"'. This issue affected nearly all sections of the documentation, so went beyond just beans.xml

* fixed table overflow in the "Using filters to customize scanning" section (approx. p.90)

* fixed all code overflows in <programlisting/> elements

* corrected a couple minor syntax errors with SpEL examples (missing closing braces)

* added 'language="..."' element to <programlisting> elements where appropriate to enable syntax highlighting.

* normalized all code indention to four-space (some code listings were using one- and two-space)

* updated all code listings to use same-line opening braces.

* eliminated section regarding backward compatibility with Spring DTDs and singleton=true|false.  This seems like cruft to me, and we shouldn't keep historical notes around forever.

* Added <note> regarding the new thread scope (SimpleThreadScope) to Section 3.5 Bean Scopes.  Also updated the section on registering a custom Scope implementation to use the SimpleThreadScope as an example.

* updated the new-in-3.xml section to improve the @Configuration example

spring-framework-reference/src/portlet.xml

@@ -116,7 +116,7 @@
       normal and global). This is not a specific feature of Spring Portlet MVC
       itself, but rather of the <interfacename>WebApplicationContext</interfacename>
       container(s) that Spring Portlet MVC uses. These bean scopes are described
-      in detail in the section entitled <xref linkend="beans-factory-scopes-other"/></para>
+      in detail in <xref linkend="beans-factory-scopes-other"/></para>
     </section>
 
     <note>
@@ -921,8 +921,8 @@ public class SampleController extends AbstractController {
     the view technologies from Spring Web MVC. This includes not only the
     various <interfacename>View</interfacename> implementations themselves,
     but also the <interfacename>ViewResolver</interfacename> implementations.
-    For more information, refer to the sections entitled
-    <xref linkend="view"/> and <xref linkend="mvc-viewresolver"/> respectively.</para>
+    For more information, refer to <xref linkend="view"/> and
+    <xref linkend="mvc-viewresolver"/> respectively.</para>
 
     <para>A few items on using the existing <interfacename>View</interfacename> and
     <interfacename>ViewResolver</interfacename> implementations  are worth mentioning:</para>
@@ -1798,4 +1798,4 @@ public class MyFormController {
     of your portlets.</para>
   </section>
 
-</chapter>
+</chapter>