rspec/rules/S117/java/rule.adoc
Fred Tingaud 16f6c0aecf
Inline adoc when include has no additional value (#1940)
Inline adoc files when they are included exactly once.

Also fix language tags because this inlining gives us better information
on what language the code is written in.
2023-05-25 14:18:12 +02:00

74 lines
1.0 KiB
Plaintext

== Why is this an issue?
include::../description.adoc[]
=== Noncompliant code example
With the default regular expression ``++^[a-z][a-zA-Z0-9]*$++``:
[source,java]
----
public void doSomething(int my_param) {
int LOCAL;
...
}
----
=== Compliant solution
[source,java]
----
public void doSomething(int myParam) {
int local;
...
}
----
=== Exceptions
Loop counters are ignored by this rule.
[source,java]
----
for (int i_1 = 0; i_1 < limit; i_1++) { // Compliant
// ...
}
----
as well as one-character ``++catch++`` variables:
[source,java]
----
try {
//...
} catch (Exception e) { // Compliant
}
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
include::../message.adoc[]
=== Parameters
.format
****
----
^[a-z][a-zA-Z0-9]*$
----
Regular expression used to check the names against.
****
'''
== Comments And Links
(visible only on this page)
include::../comments-and-links.adoc[]
endif::env-github,rspecator-view[]