rspec/rules/S2029/rpg/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

57 lines
1.9 KiB
Plaintext

== Why is this an issue?
Using both ``++SPACEA++`` (space-after) and ``++SPACEB++`` (space-before) in the same printer file can make it difficult to understand how many blank lines will be printed where. Therefore either one command or the other should be used but not both.
=== Noncompliant code example
[source,rpg]
----
A R REP001 TEXT('Detail line. ')
A SPACEB(1)
A SPACEA(1)
A 2'Additional Details for Student :'
A VAR01 6 36TEXT('Additional Details for +
A Student')
----
=== Compliant solution
[source,rpg]
----
A R REP001 TEXT('Detail line. ')
A SPACEB(1)
A 2'Additional Details for Student :'
A VAR01 6 36TEXT('Additional Details for +
A Student')
A SPACEB(1)
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
There are n SPACEA and m SPACEB commands in this file.
'''
== Comments And Links
(visible only on this page)
=== on 22 Sep 2014, 06:51:00 Ann Campbell wrote:
Note that this rule is actually for DDS, the record-format specification for RPG, rather than for RPG itself.
=== on 12 Oct 2014, 17:59:37 Freddy Mallet wrote:
@Ann, what do you mean by DDS because anyway we're going to analyze only RPG programs ?
=== on 12 Oct 2014, 22:20:44 Ann Campbell wrote:
\[~pierre-yves.nicolas] has said that he needs to analyze DDS eventually to have a full symbol table for RPG since DDS files describe data structures [~freddy.mallet]
endif::env-github,rspecator-view[]