Add description to RPGLE/CLLE programs compiled from IFS

[heymchri]

The https://codefori.github.io/docs/developing/local/structure/ page mentions that you can add a description to a program object by adding something like this in the program source:
// %TEXT: This program is for order entry
but this does not seem to work, at least not for ILE RPG.
However, ctl-opt text('...') works OK.

I've also tried to add this for a CLLE program as follows:
/* %TEXT: This program is for order entry */
but that doesn't seem to do anything either.

Is this broken or am I misunderstanding how this is supposed to work?

[sebjulliand]

%TEXT is like a metadata that can be picked up by the third-party tool you'll use to build your application (e.g. BoB).
Standard compilation commands will not pick up this information to put in on the compiled object; Code for i actions won't either since they are just made to call commands (and they are not a build tool per se, just a mean of running compile commands or build commands from the IDE).

[chrjorgensen]

FWIW, I use ctl-opt text('<text>') in RPGLE sources, dclprcopt text('<text>') in CLLE sources and cmd prompt('<text>') text(*cmdpmt) in CMD sources, which is picked up by the compilers.

The page could maybe need an explanation that the build tool is responsible for picking up the %TEXT value...

[heymchri]

%TEXT is like a metadata that can be picked up by the third-party tool you'll use to build your application (e.g. BoB).
Standard compilation commands will not pick up this information to put in on the compiled object; Code for i actions won't either since they are just made to call commands (and they are not a build tool per se, just a mean of running compile commands or build commands from the IDE).

Alternatively, the following can be used, which will be picked up by the compilers:

• RPGLE: ctl-opt text('')
• CLLE: dclprcopt text('')
• CMD: cmd prompt('') text(*cmdpmt)