Spring/spring-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

updates made during my review of beans.xml:

Browse Source 
* 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
This commit is contained in:
Chris Beams
2009-08-31 05:36:34 +00:00
parent 7b6029d515
commit 19bccaaa11
17 changed files with 209 additions and 233 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
spring-framework-reference/src/xsd-configuration.xml
View File

@@ -364,7 +364,7 @@ public class Client {
<interfacename>List</interfacename> implementation will be chosen by the container.</para>
<para>Finally, you can also control the merging behavior using the
<literal>'merge'</literal> attribute of the <literal>&lt;util:list/&gt;</literal>
element; collection merging is described in more detail in the section entitled
element; collection merging is described in more detail in
<xref linkend="beans-collection-elements-merging"/>.</para>
</section>
<section id="xsd-config-body-schemas-util-map">
@@ -409,7 +409,7 @@ public class Client {
<interfacename>Map</interfacename> implementation will be chosen by the container.</para>
<para>Finally, you can also control the merging behavior using the
<literal>'merge'</literal> attribute of the <literal>&lt;util:map/&gt;</literal>
element; collection merging is described in more detail in the section entitled
element; collection merging is described in more detail in
<xref linkend="beans-collection-elements-merging"/>.</para>
</section>
<section id="xsd-config-body-schemas-util-set">
@@ -454,7 +454,7 @@ public class Client {
<interfacename>Set</interfacename> implementation will be chosen by the container.</para>
<para>Finally, you can also control the merging behavior using the
<literal>'merge'</literal> attribute of the <literal>&lt;util:set/&gt;</literal>
element; collection merging is described in more detail in the section entitled
element; collection merging is described in more detail in
<xref linkend="beans-collection-elements-merging"/>.</para>
</section>
</section>
@@ -776,19 +776,19 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
</section>
<section id="xsd-config-body-schemas-context-component-scan">
<title><literal>&lt;component-scan/&gt;</literal></title>
<para>This element is detailed in the section entitled <xref linkend="beans-annotation-config"/>.</para>
<para>This element is detailed in <xref linkend="beans-annotation-config"/>.</para>
</section>
<section id="xsd-config-body-schemas-context-ltw">
<title><literal>&lt;load-time-weaver/&gt;</literal></title>
<para>This element is detailed in the section entitled <xref linkend="aop-aj-ltw"/>.</para>
<para>This element is detailed in <xref linkend="aop-aj-ltw"/>.</para>
</section>
<section id="xsd-config-body-schemas-context-sc">
<title><literal>&lt;spring-configured/&gt;</literal></title>
<para>This element is detailed in the section entitled <xref linkend="aop-atconfigurable"/>.</para>
<para>This element is detailed in <xref linkend="aop-atconfigurable"/>.</para>
</section>
<section id="xsd-config-body-schemas-context-mbe">
<title><literal>&lt;mbean-export/&gt;</literal></title>
<para>This element is detailed in the section entitled <xref linkend="jmx-context-mbeanexport"/>.</para>
<para>This element is detailed in <xref linkend="jmx-context-mbeanexport"/>.</para>
</section>
</section>
@@ -811,7 +811,7 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schem
<para>Last but not least we have the tags in the <literal>beans</literal> schema.
These are the same tags that have been in Spring since the very dawn of the framework.
Examples of the various tags in the <literal>beans</literal> schema are not shown here
because they are quite comprehensively covered in the section entitled <xref linkend="beans-factory-properties-detailed"/>
because they are quite comprehensively covered in <xref linkend="beans-factory-properties-detailed"/>
(and indeed in that entire <link linkend="beans">chapter</link>).</para>
<para>One thing that is new to the beans tags themselves in Spring 2.0 is the idea
of arbitrary bean metadata. In Spring 2.0 it is now possible to add zero or more