Skip to content

Commit dca5523

Browse files
committed
Stop documenting use of -debug compiler flag in reference manual
Closes gh-33453
1 parent 61b5b1e commit dca5523

File tree

4 files changed

+12
-11
lines changed

4 files changed

+12
-11
lines changed

framework-docs/modules/ROOT/pages/core/beans/context-introduction.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -644,7 +644,7 @@ Each `SpEL` expression evaluates against a dedicated context. The following tabl
644644
items made available to the context so that you can use them for conditional event processing:
645645

646646
[[context-functionality-events-annotation-tbl]]
647-
.Event SpEL available metadata
647+
.Event metadata available in SpEL expressions
648648
|===
649649
| Name| Location| Description| Example
650650

@@ -660,8 +660,8 @@ items made available to the context so that you can use them for conditional eve
660660

661661
| __Argument name__
662662
| evaluation context
663-
| The name of any of the method arguments. If, for some reason, the names are not available
664-
(for example, because there is no debug information in the compiled byte code), individual
663+
| The name of a particular method argument. If the names are not available
664+
(for example, because the code was compiled without the `-parameters` flag), individual
665665
arguments are also available using the `#a<#arg>` syntax where `<#arg>` stands for the
666666
argument index (starting from 0).
667667
| `#blEvent` or `#a0` (you can also use `#p0` or `#p<#arg>` parameter notation as an alias)

framework-docs/modules/ROOT/pages/core/beans/dependencies/factory-collaborators.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -211,8 +211,8 @@ example shows:
211211
----
212212

213213
Keep in mind that, to make this work out of the box, your code must be compiled with the
214-
debug flag enabled so that Spring can look up the parameter name from the constructor.
215-
If you cannot or do not want to compile your code with the debug flag, you can use the
214+
`-parameters` flag enabled so that Spring can look up the parameter name from the constructor.
215+
If you cannot or do not want to compile your code with the `-parameters` flag, you can use the
216216
https://download.oracle.com/javase/8/docs/api/java/beans/ConstructorProperties.html[@ConstructorProperties]
217217
JDK annotation to explicitly name your constructor arguments. The sample class would
218218
then have to look as follows:

framework-docs/modules/ROOT/pages/core/beans/dependencies/factory-properties-detailed.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -582,7 +582,7 @@ it needs to be declared in the XML file even though it is not defined in an XSD
582582
(it exists inside the Spring core).
583583

584584
For the rare cases where the constructor argument names are not available (usually if
585-
the bytecode was compiled without debugging information), you can use fallback to the
585+
the bytecode was compiled without the `-parameters` flag), you can fall back to the
586586
argument indexes, as follows:
587587

588588
[source,xml,indent=0,subs="verbatim,quotes"]

framework-docs/modules/ROOT/pages/integration/cache/annotations.adoc

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -332,7 +332,7 @@ metadata, such as the argument names. The following table describes the items ma
332332
available to the context so that you can use them for key and conditional computations:
333333

334334
[[cache-spel-context-tbl]]
335-
.Cache SpEL available metadata
335+
.Cache metadata available in SpEL expressions
336336
|===
337337
| Name| Location| Description| Example
338338

@@ -358,7 +358,7 @@ available to the context so that you can use them for key and conditional comput
358358

359359
| `args`
360360
| Root object
361-
| The arguments (as array) used for invoking the target
361+
| The arguments (as an object array) used for invoking the target
362362
| `#root.args[0]`
363363

364364
| `caches`
@@ -368,9 +368,10 @@ available to the context so that you can use them for key and conditional comput
368368

369369
| Argument name
370370
| Evaluation context
371-
| Name of any of the method arguments. If the names are not available
372-
(perhaps due to having no debug information), the argument names are also available under the `#a<#arg>`
373-
where `#arg` stands for the argument index (starting from `0`).
371+
| The name of a particular method argument. If the names are not available
372+
(for example, because the code was compiled without the `-parameters` flag), individual
373+
arguments are also available using the `#a<#arg>` syntax where `<#arg>` stands for the
374+
argument index (starting from 0).
374375
| `#iban` or `#a0` (you can also use `#p0` or `#p<#arg>` notation as an alias).
375376

376377
| `result`

0 commit comments

Comments
 (0)