Convert all docbook XML files to well-formed docbook 5 syntax:
- Include xsi:schemaLocation element for tools support
- Convert all id elements to xml:id
- Convert all ulink elements to link
- Simplify <lineannotation> mark-up
- Fix misplaced </section> tags
- Fix <interface> tags to <interfacename>
- Cleanup trailing whitespace and tabs
Issue: SPR-10032
This change eliminates the spring-framework-reference subproject, moving
these sources into the root project's own src directory.
This makes sense because the reference docs span all submodules, and
also because api Javadoc is created at the root project level as well.
This means that both api and reference documentation output will now
reside in the root project's 'build' directory. This is more consistent
and easy to discover.
* 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
Phillip Webb
Chin Huang
Chris Beams
Juergen Hoeller
Arjen Poutsma
Thomas Risberg