#147 rexx -v and -e execution options not documented

[Mark Gaubatz]

Linux #45-Ubuntu SMP Tue Jun 30 19:49:51 UTC 2009.2.6.28-13-generic
Open Object Rexx Version 4.0.0 (RC 2)
Build date: Jul 13 2009
Addressing Mode: 32

Issuing "rexx" alone without arguments returns:

rexx

Syntax is "rexx [-v] filename [arguments]"
or "rexx [-e] program_string [arguments]".

While it is possible to deduce the meanings of the two execution options, they are nonetheless undocumented as far as I can tell within either the reference or programmer's guide, as is the use of "program_string".

[Mark Miesfeld]

Where do you think that documentation should go?

[Mark Gaubatz]

In pre-object Rexx manuals and in the REXX370 compiler manual, this information generally begins in the first section of Chapter 2. In ooRexx manuals, this would be at the end of the first section in Chapter 1 of the Reference manual.

There is also some conceptual information that should be placed in the first section as well, but I'll try to write that request up as an RFE. The documentation presently jumps fully into oo discussion without first laying out the "justifications" [see non-ooRexx Reference Manual]. The present manuals "assume" a tacit foreknowledge of the prior principles of Rexx.

[Mark Miesfeld]

Committed revision 4937.

There was already a section in the programmer's guide, 3.2 "Running a Rexx Program" that dealt with this area, so I added the doc there. The placement of that section is logical within the current structure of the programmer's guide.