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/jdbc.xml

@@ -602,7 +602,7 @@ public int countOfActors(Actor exampleActor) {
       <interfacename>JdbcOperations</interfacename>
       interface</emphasis>.</para>
 
-      <para>See also the section entitled <xref
+      <para>See also <xref
       linkend="jdbc-JdbcTemplate-idioms" /> for some advice on how to best use
       the <classname>NamedParameterJdbcTemplate</classname> class in the
       context of an application.</para>
@@ -696,10 +696,9 @@ public Actor findActor(String specialty, int age) {
     return this.simpleJdbcTemplate.queryForObject(sql, mapper, specialty, age);
 }</programlisting>
 
-      <para>See also the section entitled <xref
-      linkend="jdbc-JdbcTemplate-idioms" /> for some advice on how to best use
-      the <classname>SimpleJdbcTemplate</classname> class in the context of an
-      application.</para>
+      <para>See also <xref linkend="jdbc-JdbcTemplate-idioms" />
+      for some advice on how to best use the <classname>SimpleJdbcTemplate</classname>
+      class in the context of an application.</para>
 
       <note>
         <para>The <classname>SimpleJdbcTemplate</classname> class only offers
@@ -2755,4 +2754,4 @@ public class DataAccessUnitTestTemplate {
 ]]></programlisting>    	
     </section>
   </section>
-</chapter>
+</chapter>