Post by Stefan on Oct 14, 2022 5:26:00 GMT -5
The documentation describes the GET_WORDCHAR$ function as:
"Returns a string containing all the characters which are considered valid Word characters for the current Profile."
The '...for the current Profile' part of the description is confusing without further explanation.
The '...for the current Profile' part of the description is confusing without further explanation.
From the user's perspective, the WORD chars "for the current profile" are those displayed by the WORD line command or the PROFILE command, for example: A-Z a-z _ $
I appreciate that you include all the foreign characters in the "A-Z" and "a-z" range, which explains the string returned by Get_WORDCHAR$, but it is still misleading.
If a user wants PRECISELY the range "A-Z a-z $ _" , s/he needs to specifiy a WORD line of A-Y Z a-y z _ $
In addition to the current description, the documentation should explain this behaviour, e.g.
"Note that the function automatically includes all foreign language characters which fall logically into the upper (A-Z) and lower (a-z) case character ranges.
To exclude foreign language characters from these ranges, code the PROFILE WORD string like this: A-Y Z a-y z
For related information, refer to the WORD lne command or the PROFILE primary command"
In addition,
- The section for the PROFILE primary command doesn't discuss the WORD line at all and would benefit from a cross reference to the WORD line command.
- The section for the WORD line command section should also include the above statement about the automatic inclusion of foreign characters in the A-Z, a-z line ranges, and how to avoid this.
