rspec/rules/S1471/cobol/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

67 lines
1.3 KiB
Plaintext

== Why is this an issue?
Portability issues may restrict which characters should be used in an identifier.
This rule checks identifier names against a regular expression of disallowed characters. Due to a technical limitation, the COBOL analyzer is not able for the time-being to differentiate lowercase from uppercase characters.
=== Noncompliant code example
With the default regular expression ``++[^a-zA-Z0-9-]++``:
[source,cobol]
----
MOVE DATA-1 TO DATA_2 *> Noncompliant; '_' not allowed
----
=== Compliant solution
[source,cobol]
----
MOVE DATA-1 TO DATA-2
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
Remove the prohibited characters from the identifier "{...}".
=== Parameters
.regex
****
----
[^a-zA-Z0-9-]
----
Regular expression to be used to detect prohibited characters
****
'''
== Comments And Links
(visible only on this page)
=== on 12 Apr 2016, 20:37:11 Ann Campbell wrote:
\[~pierre-yves.nicolas] I just came across this rule and I'm wondering if this part is still true:
____
Due to a technical limitation, the COBOL analyzer is not able for the time-being to differentiate lowercase from uppercase characters.
____
=== on 14 Apr 2016, 09:59:56 Pierre-Yves Nicolas wrote:
\[~ann.campbell.2] This limitation still exists.
endif::env-github,rspecator-view[]