rspec/rules/S1461/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

34 lines
878 B
Plaintext

== Why is this an issue?
An unused section is never called explicitly with help of the GO TO or PERFORM statements.
There can be only two reasons for having such a section:
* It is really unused and should be removed
* It is only used as a kind of comment to clearly delimit a block of code, which is a bad practice
The remediation action should be:
* Replace the section by a comment line
* Refactor the code to make an explicit call to this section instead of letting the execution flow going through it implicitly
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
Either this section "XXX" is a dead code that must be removed or the code must be refactored to make an explicit call to it.
'''
== Comments And Links
(visible only on this page)
=== relates to: S1290
endif::env-github,rspecator-view[]