[Oorexx-bugs] [ oorexx-Bugs-1665315 ] Incorrect information on case sensitive files

[SourceForge.net <no...@so...>]

Bugs item #1665315, was opened at 2007-02-21 09:23
Message generated for change (Comment added) made by wdashley
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=684730&aid=1665315&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: Closed
>Resolution: Fixed
Priority: 5
Private: No
Submitted By: Swifty (steve_j_swift)
>Assigned to: David Ashley (wdashley)
Summary: Incorrect information on case sensitive files

Initial Comment:
I was directed to http://www.oorexx.org/rexxref/x17001.htm#XSEARCHO and there I found:

"File names can be in uppercase, lowercase, or mixed case. The operating system uses a case-insensitive search for files. When calling a Rexx subroutine, the case of the name does not matter." 

I've discovered that in order to call an external subroutine/function on a system that uses case-sensitive filenames (such as Linux) you have to adopt one of two approaches:

1. You name the external routine in upper case, i.e. FILEREAD and then you can call it one of two ways:
   a: Call Fileread      /* unquoted, case is ignored in the code */
   b: Call 'FILEREAD'    /* Quotes; Case *must match filesystem   */
2. You name the external routine in lower or mixed case, i.e. FileRead
   and then you can call it one way only:
   a: Call 'FileRead' 

----------------------------------------------------------------------

>Comment By: David Ashley (wdashley)
Date: 2007-02-21 09:48

Message:
Logged In: YES 
user_id=931756
Originator: NO

I updated the docs to remove the "and external routines" phrase.

----------------------------------------------------------------------

Comment By: Rick McGuire (bigrixx)
Date: 2007-02-21 09:31

Message:
Logged In: YES 
user_id=1125291
Originator: NO

There is also a bit of an inaccuracy in the description of the CALL
instruction itself.  It has the sentence "Note that the names of built-in
functions [AND EXTERNAL ROUTINES] are in uppercase."  This is really only
true for the built-in functions.  The search for external functions allows
the possibility for non-uppercase names.  In fact, the information in the
next two paragraphs flatly contradicts the AND EXTERNAL ROUTINES portion of
that sentence. 

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=684730&aid=1665315&group_id=119701