2021-04-28 16:49:39 +02:00
|
|
|
Every macro should be commented to explain its goal and how it works. This comment can be located just before or after the macro definition.
|
|
|
|
|
2021-04-28 18:08:03 +02:00
|
|
|
|
2021-04-28 16:49:39 +02:00
|
|
|
== Noncompliant Code Example
|
|
|
|
|
|
|
|
----
|
|
|
|
DEFINE my_macro.
|
|
|
|
...
|
|
|
|
END-OF-DEFINITION.
|
|
|
|
----
|
|
|
|
|
2021-04-28 18:08:03 +02:00
|
|
|
|
2021-04-28 16:49:39 +02:00
|
|
|
== Compliant Solution
|
|
|
|
|
|
|
|
----
|
|
|
|
* here is
|
|
|
|
* my comment
|
|
|
|
DEFINE my_macro.
|
|
|
|
...
|
|
|
|
END-OF-DEFINITION.
|
|
|
|
----
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
|
|
----
|
|
|
|
DEFINE my_macro.
|
|
|
|
* here is
|
|
|
|
* my comment
|
|
|
|
...
|
|
|
|
END-OF-DEFINITION.
|
|
|
|
----
|
2021-04-28 18:08:03 +02:00
|
|
|
|
|
|
|
|
2021-09-20 15:38:42 +02:00
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
|
|
|
|
'''
|
|
|
|
== Implementation Specification
|
|
|
|
(visible only on this page)
|
|
|
|
|
|
|
|
include::message.adoc[]
|
|
|
|
|
|
|
|
endif::env-github,rspecator-view[]
|