Bill Woodger
Moderator Emeritus
Joined: 09 Mar 2011
Posts: 7309
Location: Inside the Matrix
|
|
|
|
| dbzTHEdinosauer wrote: |
no, i do not agree that it is a documentation error.
one of the problems of IBM manuals is that they expect you to remember the info on page 1 as you read page 2.
in the E-cobol programmers guide in Section 8.1.4.1 Optimization it simply says:
| Enterprise COBOL for z/OS V4.2 Programming Guide: 2.4.40 wrote: |
| Discard unreferenced data items from the DATA DIVISION, and suppress generation of code to initialize these data items to their VALUE clauses. (The optimizer takes this action only when you use the FULL suboption.) |
|
OK, so from the quote we started off with "The FULL suboption requests that... the compiler discard unreferenced data items from the DATA DIVISION and suppress generation of code to initialize these data items to the values in their VALUE clauses."
We're talking about the same thing then. This quote is from "Enterprise COBOL for z/OS Programming Guide Version 4 Release 2"... er... kind of similar. PDF version. Document no SC23-8529-01. Perhaps it is already updated. One way to "fix" the manual is to take out the bits that are wrong. The paragraph you quote is expanded to give a more exact description in the quote from the PDF. Giving the more exact description then made it wrong (by ignoring the affects of redefines). If yours is more up-to-date, then maybe they've already fixed it.
I agree that there is a "technique" to reading IBM manuals. I disagree that that technique involves understanding which of more than one concept for a particular phrase you need to use on this particular page or that.
If your manual, by yours I mean "theirs" but the one you quoted, is more up-to-date, then I'm happy that the text giving me concern is no longer a problem (because it isn't there). |
|
