Fix typos, formatting and escaping in reference

Note: Some symbol combinations (including <=) serve as textual symbol
replacements in AsciiDoc.

http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#text-replacement
This commit is contained in:
Bian Jiaping 2017-11-20 10:00:54 +08:00 committed by Rossen Stoyanchev
parent 22a8a668c9
commit 8f525f07e9
6 changed files with 27 additions and 27 deletions

View File

@ -46,7 +46,7 @@ import java.lang.annotation.Target;
* beans, provide stub implementations of your lookup methods to be able to declare
* them as concrete classes. And please remember that lookup methods won't work on
* beans returned from {@code @Bean} methods in configuration classes; you'll have
* to resort to {@code @Inject Provider&lt;TargetBean&gt;} or the like instead.
* to resort to {@code @Inject Provider<TargetBean>} or the like instead.
*
* @author Juergen Hoeller
* @since 4.1

View File

@ -5624,7 +5624,7 @@ support for autowiring of `@Bean` methods:
}
----
The example autowires the `String` method parameter `country` to the value of the `Age`
The example autowires the `String` method parameter `country` to the value of the `age`
property on another bean named `privateInstance`. A Spring Expression Language element
defines the value of the property through the notation `#{ <expression> }`. For `@Value`
annotations, an expression resolver is preconfigured to look for bean names when

View File

@ -778,11 +778,11 @@ expression based `matches` operator.
// evaluates to true
boolean trueValue = parser.parseExpression(
"'5.00' matches '\^-?\\d+(\\.\\d{2})?$'").getValue(Boolean.class);
"'5.00' matches '^-?\\d+(\\.\\d{2})?$'").getValue(Boolean.class);
//evaluates to false
boolean falseValue = parser.parseExpression(
"'5.0067' matches '\^-?\\d+(\\.\\d{2})?$'").getValue(Boolean.class);
"'5.0067' matches '^-?\\d+(\\.\\d{2})?$'").getValue(Boolean.class);
----
[NOTE]
@ -795,7 +795,7 @@ evaluates to `true`, as expected.
Each symbolic operator can also be specified as a purely alphabetic equivalent. This
avoids problems where the symbols used have special meaning for the document type in
which the expression is embedded (eg. an XML document). The textual equivalents are
shown here: `lt` (`<`), `gt` (`>`), `le` (`<=`), `ge` (`>=`), `eq` (`==`),
shown here: `lt` (`<`), `gt` (`>`), `le` (`\<=`), `ge` (`>=`), `eq` (`==`),
`ne` (`!=`), `div` (`/`), `mod` (`%`), `not` (`!`). These are case insensitive.
@ -1230,7 +1230,8 @@ where the entry value is less than 27.
In addition to returning all the selected elements, it is possible to retrieve just the
first or the last value. To obtain the first entry matching the selection the syntax is
`^[...]` whilst to obtain the last matching selection the syntax is `$[...]`.
`.^[selectionExpression]` whilst to obtain the last matching selection the syntax is
`.$[selectionExpression]`.
@ -1238,7 +1239,7 @@ first or the last value. To obtain the first entry matching the selection the sy
=== Collection Projection
Projection allows a collection to drive the evaluation of a sub-expression and the
result is a new collection. The syntax for projection is `![projectionExpression]`. Most
result is a new collection. The syntax for projection is `.![projectionExpression]`. Most
easily understood by example, suppose we have a list of inventors but want the list of
cities where they were born. Effectively we want to evaluate 'placeOfBirth.city' for
every entry in the inventor list. Using projection:

View File

@ -494,9 +494,9 @@ When the path location contains an Ant-style pattern, for example:
[subs="verbatim"]
----
/WEB-INF/*-context.xml
com/mycompany/**/applicationContext.xml
file:C:/some/path/*-context.xml
classpath:com/mycompany/**/applicationContext.xml
com/mycompany/**/applicationContext.xml
file:C:/some/path/*-context.xml
classpath:com/mycompany/**/applicationContext.xml
----
The resolver follows a more complex but defined procedure to try to resolve the
@ -512,7 +512,7 @@ the wildcards.
===== Implications on portability
If the specified path is already a file URL (either explicitly, or implicitly because
the base `ResourceLoader` is a filesystem one, then wildcarding is guaranteed to work in
the base `ResourceLoader` is a filesystem one), then wildcarding is guaranteed to work in
a completely portable fashion.
If the specified path is a classpath location, then the resolver must obtain the last

View File

@ -209,7 +209,7 @@ generation (including validation error display). It is never necessary to use th
macros to generate form input fields, and they can be mixed and matched with simple HTML
or calls direct to the spring bind macros highlighted previously.
The following table of available macros show the VTL and FTL definitions and the
The following table of available macros show the FTL definitions and the
parameter list that each takes.
[[views-macros-defs-tbl]]
@ -262,9 +262,9 @@ parameter list that each takes.
| <@spring.showErrors separator, classOrStyle/>
|===
* In FTL (FreeMarker), these two macros are not actually required as you can use the
normal `formInput` macro, specifying ' `hidden`' or ' `password`' as the value for the
`fieldType` parameter.
* In FTL (FreeMarker), `formHiddenInput` and `formPasswordInput` are not actually required
as you can use the normal `formInput` macro, specifying `hidden` or `password` as the
value for the `fieldType` parameter.
The parameters to any of the above macros have consistent meanings:
@ -420,14 +420,14 @@ your model where they will be visible to your templates). The advantage of speci
them in the templates is that they can be changed to different values later in the
template processing to provide different behavior for different fields in your form.
To switch to XHTML compliance for your tags, specify a value of 'true' for a
To switch to XHTML compliance for your tags, specify a value of `true` for a
model/context variable named xhtmlCompliant:
[source,jsp,indent=0]
[subs="verbatim,quotes"]
----
<#-- for FreeMarker -->
<#assign xhtmlCompliant = true in spring>
<#assign xhtmlCompliant = true>
----
Any tags generated by the Spring macros will now be XHTML compliant after processing
@ -435,12 +435,12 @@ this directive.
In similar fashion, HTML escaping can be specified per field:
[source,xml,indent=0]
[source,jsp,indent=0]
[subs="verbatim,quotes"]
----
<#-- until this point, default HTML escaping is used -->
<#assign htmlEscape = true in spring>
<#assign htmlEscape = true>
<#-- next field will use HTML escaping -->
<@spring.formInput "command.name"/>

View File

@ -479,7 +479,7 @@ initialization parameters ( `init-param` elements) to the Servlet declaration in
All `HandlerMapping` implementations supports handler interceptors that are useful when
you want to apply specific functionality to certain requests, for example, checking for
a principal. Interceptors must implement `HandlerInterceptor` from the
`org.springframework .web .servlet` package with three methods that should provide enough
`org.springframework.web.servlet` package with three methods that should provide enough
flexibility to do all kinds of pre-processing and post-processing:
* `preHandle(..)` -- __before__ the actual handler is executed
@ -498,7 +498,7 @@ configure interceptors. You can also register them directly via setters on indiv
`HandlerMapping` implementations.
Note that `postHandle` is less useful with `@ResponseBody` and `ResponseEntity` methods for
which a the response is written and committed within the `HandlerAdapter` and before
which the response is written and committed within the `HandlerAdapter` and before
`postHandle`. That means its too late to make any changes to the response such as adding
an extra header. For such scenarios you can implement `ResponseBodyAdvice` and either
declare it as an <<mvc-ann-controller-advice>> bean or configure it directly on
@ -2543,8 +2543,8 @@ on a container object that specifies request headers and body. Below is an examp
@PostMapping("/something")
public ResponseEntity<String> handle() {
// ...
URI location = ...
return new ResponseEntity.created(location).build();
URI location = ... ;
return ResponseEntity.created(location).build();
}
----
@ -4167,8 +4167,7 @@ And the same in XML use the `<mvc:view-controller>` element:
The MVC config simplifies the registration of view resolvers.
The following is a Java config example that configures content negotiation view
resolution using FreeMarker HTML templates and Jackson as a default `View` for
JSON rendering:
resolution using JSP and Jackson as a default `View` for JSON rendering:
[source,java,indent=0]
[subs="verbatim,quotes"]
@ -4296,8 +4295,8 @@ See also
<<mvc-caching-static-resources, HTTP caching support for static resources>>.
The resource handler also supports a chain of
{api-spring-framework}/web/servlet/resource/ResourceResolver.html[ResourceResolver]'s and
{api-spring-framework}/web/servlet/resource/ResourceTransformer.html[ResourceTransformer]'s.
{api-spring-framework}/web/servlet/resource/ResourceResolver.html[ResourceResolver]s and
{api-spring-framework}/web/servlet/resource/ResourceTransformer.html[ResourceTransformer]s.
which can be used to create a toolchain for working with optimized resources.
The `VersionResourceResolver` can be used for versioned resource URLs based on an MD5 hash