From 72c4e6157cf1f0e3a086e1dae20ddc7f332d608c Mon Sep 17 00:00:00 2001 From: Sam Brannen Date: Wed, 29 Jul 2015 22:26:56 +0200 Subject: [PATCH] Polish appendices in the reference manual --- src/asciidoc/appendix.adoc | 15 ++++++------- src/asciidoc/appx-spring-form-tld.adoc | 30 +++++++++++++------------- src/asciidoc/appx-spring-tld.adoc | 22 +++++++++---------- 3 files changed, 33 insertions(+), 34 deletions(-) diff --git a/src/asciidoc/appendix.adoc b/src/asciidoc/appendix.adoc index e4595b8e608..466e1f88a00 100644 --- a/src/asciidoc/appendix.adoc +++ b/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 -<> chapter. +<> chapter. [[classic-spring-hibernate]] ==== Hibernate -For the currently recommended usage patterns for Hibernate see <> +For the currently recommended usage patterns for Hibernate see <>. [[orm-hibernate-template]] diff --git a/src/asciidoc/appx-spring-form-tld.adoc b/src/asciidoc/appx-spring-form-tld.adoc index 080f41cb136..7693346dcf7 100644 --- a/src/asciidoc/appx-spring-form-tld.adoc +++ b/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'. diff --git a/src/asciidoc/appx-spring-tld.adoc b/src/asciidoc/appx-spring-tld.adoc index 7a9f7f7272b..c3bb117fbd0 100644 --- a/src/asciidoc/appx-spring-tld.adoc +++ b/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.