Skip to content

Commit 9ca407d

Browse files
odrotbohmcbeams
authored andcommitted
Add missing section ids in reference documentation
Add missing id attributes to <section> elements in the reference documentation to ensure stable anchor links in HTML output. Issue: SPR-9410 Backport-Issue: SPR-9346 Backport-Commit: 2a75c57
1 parent 1380d05 commit 9ca407d

File tree

13 files changed

+86
-86
lines changed

13 files changed

+86
-86
lines changed

spring-framework-reference/src/beans-context-additional.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -610,7 +610,7 @@ argument.required=Ebagum lad, the '{0}' argument is required, I say, required.</
610610
does.</para>
611611
</section>
612612

613-
<section>
613+
<section id="context-deploy-rar">
614614
<title>Deploying a Spring ApplicationContext as a J2EE RAR file</title>
615615

616616
<para>In Spring 2.5 and later, it is possible to deploy a Spring

spring-framework-reference/src/beans-dependencies.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -264,7 +264,7 @@ public class ExampleBean {
264264
</sidebar>
265265
</section>
266266

267-
<section>
267+
<section id="beans-dependency-resolution">
268268
<title>Dependency resolution process</title>
269269

270270
<para>The container performs bean dependency resolution as follows:</para>
@@ -858,7 +858,7 @@ [email protected]</programlisting>
858858
the container uses internally.</para>
859859
</section>
860860

861-
<section>
861+
<section id="beans-collection-merge-limitations">
862862
<title>Limitations of collection merging</title>
863863

864864
<para>You cannot merge different collection types (such as a

spring-framework-reference/src/classic-spring.xml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -353,7 +353,7 @@
353353
<para>...</para>
354354
</section>
355355

356-
<section>
356+
<section id="classic-spring-jms">
357357
<title>JMS Usage</title>
358358

359359
<para>One of the benefits of Spring's JMS support is to shield the user
@@ -391,7 +391,7 @@
391391
</note>
392392
</sidebar>
393393

394-
<section>
394+
<section id="classic-spring-jms-template">
395395
<title>JmsTemplate</title>
396396

397397
<para>Located in the package
@@ -406,7 +406,7 @@
406406
that the point-to-point domain, Queues, will be used.</para>
407407
</section>
408408

409-
<section>
409+
<section id="classic-spring-aysnc-messages">
410410
<title>Asynchronous Message Reception </title>
411411

412412
<para><link
@@ -422,7 +422,7 @@
422422
rely only on the JMS 1.0.2 API. </para>
423423
</section>
424424

425-
<section>
425+
<section id="classic-spring-jms-connections">
426426
<title>Connections</title>
427427

428428
<para>The <classname>ConnectionFactory</classname> interface is part of
@@ -440,7 +440,7 @@
440440
<classname>javax.jmsTopicConnection</classname>.</para>
441441
</section>
442442

443-
<section>
443+
<section id="classic-spring-jms-tx-management">
444444
<title>Transaction Management</title>
445445

446446
<para>In a JMS 1.0.2 environment the class

spring-framework-reference/src/expressions.xml

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -276,7 +276,7 @@ String name = (String) exp.getValue(tesla);
276276
<programlisting language="java">Expression exp = parser.parseExpression("name == 'Nikola Tesla'");
277277
boolean result = exp.getValue(context, Boolean.class); // evaluates to true</programlisting>
278278

279-
<section>
279+
<section id="expressions-evaluation-context">
280280
<title>The EvaluationContext interface</title>
281281

282282
<para>The interface <interfacename>EvaluationContext</interfacename> is
@@ -305,7 +305,7 @@ boolean result = exp.getValue(context, Boolean.class); // evaluates to true</pr
305305
expressions. Please refer to the JavaDoc of these classes for more
306306
details.</para>
307307

308-
<section>
308+
<section id="expressions-type-conversion">
309309
<title>Type Conversion</title>
310310

311311
<para>By default SpEL uses the conversion service available in Spring
@@ -513,7 +513,7 @@ Object nullValue = parser.parseExpression("null").getValue();
513513
Double.parseDouble().</para>
514514
</section>
515515

516-
<section>
516+
<section id="expressions-properties-arrays">
517517
<title>Properties, Arrays, Lists, Maps, Indexers</title>
518518

519519
<para>Navigating with property references is easy, just use a period to
@@ -575,7 +575,7 @@ parser.parseExpression("Officers['advisors'][0].PlaceOfBirth.Country").setValue(
575575

576576
</programlisting>
577577
</section>
578-
<section>
578+
<section id="expressions-inline-lists">
579579
<title>Inline lists</title>
580580

581581
<para>Lists can be expressed directly in an expression using {} notation.
@@ -592,7 +592,7 @@ List listOfLists = (List) parser.parseExpression("{{'a','b'},{'x','y'}}").getVal
592592
to represent the expression, rather than building a new list on each evaluation.</para>
593593
</section>
594594

595-
<section>
595+
<section id="expressions-array-construction">
596596
<title>Array construction</title>
597597

598598
<para>Arrays can be built using the familiar Java syntax, optionally
@@ -611,7 +611,7 @@ int[][] numbers3 = (int[][]) parser.parseExpression("new int[4][5]").getValue(co
611611
a multi-dimensional array.</para>
612612
</section>
613613

614-
<section>
614+
<section id="expressions-methods">
615615
<title>Methods</title>
616616

617617
<para>Methods are invoked using typical Java programming syntax. You may
@@ -625,10 +625,10 @@ boolean isMember = parser.parseExpression("isMember('Mihajlo Pupin')").getValue(
625625
Boolean.class);</programlisting>
626626
</section>
627627

628-
<section>
628+
<section id="expressions-operators">
629629
<title>Operators</title>
630630

631-
<section>
631+
<section id="expressions-operators-relational">
632632
<title>Relational operators</title>
633633

634634
<para>The relational operators; equal, not equal, less than, less than
@@ -666,7 +666,7 @@ boolean falseValue =
666666
These are case insensitive.</para>
667667
</section>
668668

669-
<section>
669+
<section id="expressions-operators-logical">
670670
<title>Logical operators</title>
671671

672672
<para>The logical operators that are supported are and, or, and not.
@@ -701,7 +701,7 @@ String expression = "isMember('Nikola Tesla') and !isMember('Mihajlo Pupin')";
701701
boolean falseValue = parser.parseExpression(expression).getValue(societyContext, Boolean.class);</programlisting></para>
702702
</section>
703703

704-
<section>
704+
<section id="expressions-operators-mathematical">
705705
<title>Mathematical operators</title>
706706

707707
<para>The addition operator can be used on numbers, strings and dates.
@@ -742,7 +742,7 @@ int minusTwentyOne = parser.parseExpression("1+2-3*8").getValue(Integer.class);
742742
</section>
743743
</section>
744744

745-
<section>
745+
<section id="expressions-assignment">
746746
<title>Assignment</title>
747747

748748
<para>Setting of a property is done by using the assignment operator.
@@ -764,7 +764,7 @@ String aleks = parser.parseExpression("Name = 'Alexandar Seovic'").getValue(inve
764764
<para></para>
765765
</section>
766766

767-
<section>
767+
<section id="expressions-types">
768768
<title>Types</title>
769769

770770
<para>The special 'T' operator can be used to specify an instance of
@@ -786,7 +786,7 @@ boolean trueValue =
786786
</programlisting>
787787
</section>
788788

789-
<section>
789+
<section id="expressions-constrcutors">
790790
<title>Constructors</title>
791791

792792
<para>Constructors can be invoked using the new operator. The fully
@@ -820,7 +820,7 @@ parser.parseExpression("Name = #newName").getValue(context);
820820

821821
System.out.println(tesla.getName()) // "Mike Tesla"</programlisting>
822822

823-
<section>
823+
<section id="expressions-this-root">
824824
<title>The #this and #root variables</title>
825825

826826
<para>The variable #this is always defined and refers to the current
@@ -847,7 +847,7 @@ List&lt;Integer&gt; primesGreaterThanTen =
847847
</section>
848848

849849
<!--
850-
<section>
850+
<section id="expressions-root">
851851
<title>The #root variable</title>
852852
853853
<para>The variable #root is always defined and refers to the
@@ -905,7 +905,7 @@ String helloWorldReversed =
905905
parser.parseExpression("#reverseString('hello')").getValue(context, String.class);</programlisting>
906906
</section>
907907

908-
<section>
908+
<section id="expressions-bean-references">
909909
<title>Bean references</title>
910910
<para>If the evaluation context has been configured with a bean resolver it is possible to
911911
lookup beans from an expression using the (@) symbol.
@@ -918,7 +918,7 @@ context.setBeanResolver(new MyBeanResolver());
918918
Object bean = parser.parseExpression("@foo").getValue(context);</programlisting>
919919
</section>
920920

921-
<section>
921+
<section id="expressions-operator-ternary">
922922
<title>Ternary Operator (If-Then-Else)</title>
923923

924924
<para>You can use the ternary operator for performing if-then-else
@@ -944,7 +944,7 @@ String queryResultString =
944944
shorter syntax for the ternary operator.</para>
945945
</section>
946946

947-
<section>
947+
<section id="expressions-operator-elvis">
948948
<title>The Elvis Operator</title>
949949

950950
<para>The Elvis operator is a shortening of the ternary operator syntax
@@ -985,7 +985,7 @@ name = parser.parseExpression("Name?:'Elvis Presley'").getValue(context, String.
985985
System.out.println(name); // Elvis Presley</programlisting>
986986
</section>
987987

988-
<section>
988+
<section id="expressions-operator-safe-navigation">
989989
<title>Safe Navigation operator</title>
990990

991991
<para>The Safe Navigation operator is used to avoid a
@@ -1022,7 +1022,7 @@ System.out.println(city); // null - does not throw NullPointerException!!!</prog
10221022
</note>
10231023
</section>
10241024

1025-
<section>
1025+
<section id="expressions-collection-selection">
10261026
<title>Collection Selection</title>
10271027

10281028
<para>Selection is a powerful expression language feature that allows you
@@ -1057,7 +1057,7 @@ System.out.println(city); // null - does not throw NullPointerException!!!</prog
10571057
<literal>$[...]</literal>.</para>
10581058
</section>
10591059

1060-
<section>
1060+
<section id="expressions-collection-projection">
10611061
<title>Collection Projection</title>
10621062

10631063
<para>Projection allows a collection to drive the evaluation of a
@@ -1078,7 +1078,7 @@ List placesOfBirth = (List)parser.parseExpression("Members.![placeOfBirth.city]"
10781078
projection expression against each map entry.</para>
10791079
</section>
10801080

1081-
<section>
1081+
<section id="expressions-templating">
10821082
<title>Expression templating</title>
10831083

10841084
<para>Expression templates allow a mixing of literal text with one or

spring-framework-reference/src/jdbc.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2941,7 +2941,7 @@ public class DataAccessUnitTestTemplate {
29412941
</section>
29422942
</section>
29432943

2944-
<section>
2944+
<section id="jdbc-intializing-datasource">
29452945
<title>Initializing a DataSource</title>
29462946

29472947
<para>The <literal>org.springframework.jdbc.datasource.init</literal>
@@ -2951,7 +2951,7 @@ public class DataAccessUnitTestTemplate {
29512951
<classname>DataSource</classname> for an application, but sometimes you
29522952
need to initialize an instance running on a server somewhere.</para>
29532953

2954-
<section>
2954+
<section id="jdbc-initializing-datasource-xml">
29552955
<title>Initializing a database instance using Spring XML</title>
29562956

29572957
<para>If you want to initialize a database and you can provide a
@@ -3015,7 +3015,7 @@ public class DataAccessUnitTestTemplate {
30153015
can simply use the <classname>DataSourceInitializer</classname>
30163016
directly, and define it as a component in your application.</para>
30173017

3018-
<section>
3018+
<section id="jdbc-client-component-initialization">
30193019
<title>Initialization of Other Components that Depend on the
30203020
Database</title>
30213021

spring-framework-reference/src/jms.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,7 @@
139139
should ensure that it references the managed implementation of the
140140
<classname>ConnectionFactory</classname>.</para>
141141

142-
<section>
142+
<section id="jms-caching-resources">
143143
<title>Caching Messaging Resources</title>
144144

145145
<para>The standard API involves creating many intermediate objects. To
@@ -153,7 +153,7 @@
153153
IConnectionFactory are provided.</para>
154154
</section>
155155

156-
<section>
156+
<section id="jms-connection-factory">
157157
<title>SingleConnectionFactory</title>
158158

159159
<para>Spring provides an implementation of the
@@ -170,7 +170,7 @@
170170
from JNDI.</para>
171171
</section>
172172

173-
<section>
173+
<section id="jdbc-connection-factory-caching">
174174
<title>CachingConnectionFactory</title>
175175

176176
<para>The <classname>CachingConnectionFactory</classname> extends the

spring-framework-reference/src/mvc.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3593,7 +3593,7 @@ public String onSubmit(<emphasis role="bold">@RequestPart("meta-data") MetaData
35933593
<section id="mvc-exceptionhandlers">
35943594
<title>Handling exceptions</title>
35953595

3596-
<section>
3596+
<section id="mvc-exceptionhandlers-resolver">
35973597
<title
35983598
id="mvc-HandlerExceptionResolver"><interfacename>HandlerExceptionResolver</interfacename></title>
35993599

spring-framework-reference/src/new-in-3.0.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -403,7 +403,7 @@ public class AppConfig {
403403
<literal>AnnotationConfigApplicationContext</literal>.</para>
404404
</section>
405405

406-
<section>
406+
<section id="new-bean-metadata-in-components">
407407
<title>Defining bean metadata within components</title>
408408

409409
<para><literal>@Bean</literal> annotated methods are also supported
@@ -447,7 +447,7 @@ public class AppConfig {
447447
building RESTful web services and web applications. There are also some
448448
new annotations that can be used in any web application.</para>
449449

450-
<section>
450+
<section id="new-feature-rest-support">
451451
<title>Comprehensive REST support</title>
452452

453453
<para>Server-side support for building RESTful applications has been
@@ -470,7 +470,7 @@ public class AppConfig {
470470
information.</para>
471471
</section>
472472

473-
<section>
473+
<section id="new-feature-at-mvc">
474474
<title>@MVC additions</title>
475475

476476
<para>A <literal>mvc</literal> namespace has been introduced that greatly simplifies Spring MVC configuration.</para>

0 commit comments

Comments
 (0)