Polish appendices in the reference manual

src/asciidoc/appendix.adoc

@@ -1,18 +1,17 @@
 [[spring-appendices]]
 = Appendices
 
-[[migration-4.0]]
-== Migrating to Spring Framework 4.0
-Migration guides for upgrading from previous releases of the Spring Framework are now
-provided as a Wiki page. For details please refer to
-https://github.com/spring-projects/spring-framework/wiki/Migrating-from-earlier-versions-of-the-spring-framework
+[[migration-4.x]]
+== Migrating to Spring Framework 4.x
+Migration guides for upgrading from previous releases of the Spring Framework are now provided as a
+https://github.com/spring-projects/spring-framework/wiki/Migrating-from-earlier-versions-of-the-spring-framework[Wiki page].
 
 
 [[classic-spring]]
 == Classic Spring Usage
 This appendix discusses some classic Spring usage patterns as a reference for developers
 maintaining legacy Spring applications. These usage patterns no longer reflect the
-recommended way of using these features and the current recommended usage is covered in
+recommended way of using these features, and the current recommended usage is covered in
 the respective sections of the reference manual.
 
 
@@ -21,13 +20,13 @@ the respective sections of the reference manual.
 === Classic ORM usage
 This section documents the classic usage patterns that you might encounter in a legacy
 Spring application. For the currently recommended usage patterns, please refer to the
-<<orm>> chapter.
+<<orm,ORM>> chapter.
 
 
 
 [[classic-spring-hibernate]]
 ==== Hibernate
-For the currently recommended usage patterns for Hibernate see <<orm-hibernate>>
+For the currently recommended usage patterns for Hibernate see <<orm-hibernate>>.
 
 
 [[orm-hibernate-template]]

src/asciidoc/appx-spring-form-tld.adoc

@@ -1,5 +1,5 @@
 [[spring-form-tld]]
-= spring-form.tld
+= spring-form JSP Tag Library
 
 
 [[spring-form.tld-intro]]
@@ -34,7 +34,7 @@ This appendix describes the `spring-form.tld` tag library.
 
 
 [[spring-form.tld.checkbox]]
-== the checkbox tag
+== The checkbox tag
 
 Renders an HTML 'input' tag with type 'checkbox'.
 
@@ -185,7 +185,7 @@ Renders an HTML 'input' tag with type 'checkbox'.
 
 
 [[spring-form.tld.checkboxes]]
-== the checkboxes tag
+== The checkboxes tag
 
 Renders multiple HTML 'input' tags with type 'checkbox'.
 
@@ -355,7 +355,7 @@ Renders multiple HTML 'input' tags with type 'checkbox'.
 
 
 [[spring-form.tld.errors]]
-== the errors tag
+== The errors tag
 
 Renders field errors in an HTML 'span' tag.
 
@@ -475,7 +475,7 @@ Renders field errors in an HTML 'span' tag.
 
 
 [[spring-form.tld.form]]
-== the form tag
+== The form tag
 
 Renders an HTML 'form' tag and exposes a binding path to inner tags for binding.
 
@@ -630,7 +630,7 @@ Renders an HTML 'form' tag and exposes a binding path to inner tags for binding.
 
 
 [[spring-form.tld.hidden]]
-== the hidden tag
+== The hidden tag
 
 Renders an HTML 'input' tag with type 'hidden' using the bound value.
 
@@ -660,7 +660,7 @@ Renders an HTML 'input' tag with type 'hidden' using the bound value.
 
 
 [[spring-form.tld.input]]
-== the input tag
+== The input tag
 
 Renders an HTML 'input' tag with type 'text' using the bound value.
 
@@ -832,7 +832,7 @@ Renders an HTML 'input' tag with type 'text' using the bound value.
 
 
 [[spring-form.tld.label]]
-== the label tag
+== The label tag
 
 Renders a form field label in an HTML 'label' tag.
 
@@ -952,7 +952,7 @@ Renders a form field label in an HTML 'label' tag.
 
 
 [[spring-form.tld.option]]
-== the option tag
+== The option tag
 
 Renders a single HTML 'option'. Sets 'selected' as appropriate based on bound value.
 
@@ -1078,7 +1078,7 @@ Renders a single HTML 'option'. Sets 'selected' as appropriate based on bound va
 
 
 [[spring-form.tld.options]]
-== the options tag
+== The options tag
 
 Renders a list of HTML 'option' tags. Sets 'selected' as appropriate based on bound value.
 
@@ -1209,7 +1209,7 @@ Renders a list of HTML 'option' tags. Sets 'selected' as appropriate based on bo
 
 
 [[spring-form.tld.password]]
-== the password tag
+== The password tag
 
 Renders an HTML 'input' tag with type 'password' using the bound value.
 
@@ -1386,7 +1386,7 @@ Renders an HTML 'input' tag with type 'password' using the bound value.
 
 
 [[spring-form.tld.radiobutton]]
-== the radiobutton tag
+== The radiobutton tag
 
 Renders an HTML 'input' tag with type 'radio'.
 
@@ -1537,7 +1537,7 @@ Renders an HTML 'input' tag with type 'radio'.
 
 
 [[spring-form.tld.radiobuttons]]
-== the radiobuttons tag
+== The radiobuttons tag
 
 Renders multiple HTML 'input' tags with type 'radio'.
 
@@ -1706,7 +1706,7 @@ Renders multiple HTML 'input' tags with type 'radio'.
 
 
 [[spring-form.tld.select]]
-== the select tag
+== The select tag
 
 Renders an HTML 'select' element. Supports databinding to the selected option.
 
@@ -1872,7 +1872,7 @@ Renders an HTML 'select' element. Supports databinding to the selected option.
 
 
 [[spring-form.tld.textarea]]
-== the textarea tag
+== The textarea tag
 
 Renders an HTML 'textarea'.
 

src/asciidoc/appx-spring-tld.adoc

@@ -1,5 +1,5 @@
 [[spring-tld]]
-= spring.tld
+= spring JSP Tag Library
 
 
 [[spring.tld-intro]]
@@ -30,7 +30,7 @@ This appendix describes the `spring.tld` tag library.
 
 
 [[spring.tld.bind]]
-== the bind tag
+== The bind tag
 
 Provides BindStatus object for the given bind path. The HTML escaping flag participates
 in a page-wide or application-wide setting (i.e. by HtmlEscapeTag or a
@@ -65,7 +65,7 @@ in a page-wide or application-wide setting (i.e. by HtmlEscapeTag or a
 
 
 [[spring.tld.escapeBody]]
-== the escapeBody tag
+== The escapeBody tag
 
 Escapes its enclosed body content, applying HTML escaping and/or JavaScript escaping.
 The HTML escaping flag participates in a page-wide or application-wide setting (i.e. by
@@ -93,7 +93,7 @@ HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
 
 
 [[spring.tld.hasBindErrors]]
-== the hasBindErrors tag
+== The hasBindErrors tag
 
 Provides Errors instance in case of bind errors. The HTML escaping flag participates in
 a page-wide or application-wide setting (i.e. by HtmlEscapeTag or a "defaultHtmlEscape"
@@ -122,7 +122,7 @@ context-param in web.xml).
 
 
 [[spring.tld.htmlEscape]]
-== the htmlEscape tag
+== The htmlEscape tag
 
 Sets default HTML escape value for the current page. Overrides a "defaultHtmlEscape"
 context-param in web.xml, if any.
@@ -143,7 +143,7 @@ context-param in web.xml, if any.
 
 
 [[spring.tld.message]]
-== the message tag
+== The message tag
 
 Retrieves the message with the given code, or text if code isn't resolvable. The HTML
 escaping flag participates in a page-wide or application-wide setting (i.e. by
@@ -218,7 +218,7 @@ HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
 
 
 [[spring.tld.nestedPath]]
-== the nestedPath tag
+== The nestedPath tag
 
 Sets a nested path to be used by the bind tag's path.
 
@@ -239,7 +239,7 @@ Sets a nested path to be used by the bind tag's path.
 
 
 [[spring.tld.theme]]
-== the theme tag
+== The theme tag
 
 Retrieves the theme message with the given code, or text if code isn't resolvable. The
 HTML escaping flag participates in a page-wide or application-wide setting (i.e. by
@@ -310,7 +310,7 @@ HtmlEscapeTag or a "defaultHtmlEscape" context-param in web.xml).
 
 
 [[spring.tld.transform]]
-== the transform tag
+== The transform tag
 
 Provides transformation of variables to Strings, using an appropriate custom
 PropertyEditor from BindTag (can only be used inside BindTag). The HTML escaping flag
@@ -354,7 +354,7 @@ participates in a page-wide or application-wide setting (i.e. by HtmlEscapeTag o
 
 
 [[spring.tld.url]]
-== the url tag
+== The url tag
 
 Creates URLs with support for URI template variables, HTML/XML escaping, and Javascript
 escaping. Modeled after the JSTL c:url tag with backwards compatibility in mind.
@@ -407,7 +407,7 @@ escaping. Modeled after the JSTL c:url tag with backwards compatibility in mind.
 
 
 [[spring.tld.eval]]
-== the eval tag
+== The eval tag
 
 Evaluates a Spring expression (SpEL) and either prints the result or assigns it to a
 variable.