From: SourceForge.net <no...@so...> - 2007-03-25 06:26:56
|
Bugs item #1687721, was opened at 2007-03-25 06:26 Message generated for change (Tracker Item Submitted) made by Item Submitter You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=684730&aid=1687721&group_id=119701 Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: Documentation Group: v3.1 Status: Open Resolution: None Priority: 5 Private: No Submitted By: aviatrexx (aresti) Assigned to: Nobody/Anonymous (nobody) Summary: Overlay() doc error Initial Comment: The second sentence of the ooRexx documentation for the Overlay() bif is erroneous. Background: ooRexx doc says: "Returns the string 'target', which, starting at the 'n'th character, is overlaid with the string 'new', padded or truncated to length 'length'. The overlay must extend beyond the end of the original 'target' string. If you specify 'length', it must be a positive whole number or zero. The default value for 'length' is the length of 'new'. If 'n' is greater than the length of the 'target' string, the string 'new' is padded at the beginning. The default 'pad' character is a blank, and the default value for 'n' is 1. If you specify 'n', it must be a positive whole number." Object REXX for OS/2 says: "returns the string 'target', which, starting at the 'n'th character, is overlaid with the string 'new', padded or truncated to length 'length'. If you specify 'length', it must be positive or zero. The default value for 'length' is the length of 'new'. If 'n' is greater than the length of the target string, padding is added before the 'new' string. The default 'pad' character is a blank, and the default value for 'n' is 1. If you specify 'n', it must be a positive whole number." ANSI says: "OVERLAY overlays the first argument onto the second. The third argument is the starting position of the overlay. The fourth argument is the length of the overlay and the fifth is the padding character." (I'm not sure but I think that's my prose, and it sucks. The only way I got by with it was that it was followed by the Rexx code that exactly describes what Overlay() does.) TSO/REXX says: "returns the string 'target', which, starting at the 'n'th character, is overlaid with the string 'new', padded or truncated to length 'length'. (The overlay may extend beyond the end of the original 'target' string.) If you specify 'length', it must be a positive whole number or zero. The default value for 'length' is the length of 'new'. If 'n' is greater than the length of the 'target' string, padding is added before the 'new' string. The default 'pad' character is a blank, and the default value for 'n' is 1. If you specify 'n', it must be a positive whole number." I recommend adopting the (apparently updated) TSO/REXX text as to whether the overlay must/may extend beyond the end. Also, I prefer the phrase "non-negative whole number" to "positive whole number or zero", but I'll leave that up to you. -Chip- ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=684730&aid=1687721&group_id=119701 |