home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / BDSC / BDSC-2 / L2-225.ARK / WILDCCC.DOC < prev   
Text File  |  1988-05-21  |  3KB  |  64 lines
  1.  
  2. Description of wildcard file expansion with the L2 linker (version 2.2.6)
  3. Greg Lee, November 1984
  4.  
  5. The linker option "-*" requests a special version of the runtime code in
  6. WILD.CCC to be used instead of that in C.CCC. The file WILD.CCC must of
  7. course be present.
  8.  
  9. In case a program is linked with this option, all ambiguous file names on
  10. the command line are expanded, and the resulting list of arguments is
  11. sorted alphabetically and converted to lower case before the main function
  12. is called. These actions are invisible from the point of view of the
  13. program -- that is, no special initialization or reserving of memory space
  14. is required. The expanded and sorted list is accessed through argv and argc
  15. in the ordinary way.
  16.  
  17. Notes on usage:
  18.  
  19.     1. Arguments surrounded by double quotes are passed along unchanged
  20.        to the new processed list, except that the quotes are removed,
  21.        and the argument without the quotes is sorted along with all
  22.        the other arguments. This is also true of arguments which do
  23.        not begin with hyphen (see 4 below) and do not contain "?" or "*".
  24.  
  25.     2. Any ambiguous file name given on the command line may include
  26.        a disk drive and/or user designation. After expansion and sorting,
  27.        the drive or user designation is appended to the corresponding
  28.        file names, provided it differs from the current default drive
  29.        and user.
  30.  
  31.     3. If a file satisfies more than one ambiguous reference, it will
  32.        appear more than once in the final list. That is, duplicate names
  33.        are not removed.
  34.  
  35.     4. Arguments beginning with a hyphen are treated as flag lists which
  36.        modify the processing in various ways. (Use double quotes to
  37.        pass flags through to the main program.) The following are
  38.        implemented:
  39.         -s  include files with the system attribute
  40.         -y  exclude files without the system attribute
  41.         -a  include files from all user areas
  42.         -u  use upper case
  43.  
  44.     5. The "!" provision of WILDEXP.C to exclude names is not implemented.
  45.  
  46.     6. The code to do the extra processing is 1k bytes long. (This is
  47.        about 1k less than was required by WILDEXP.C.)
  48.  
  49.     7. Memory space between the end of the externals and the top of
  50.        the tpa is used as work space. 20 bytes are required for
  51.        each name that will appear on the final sorted list. The
  52.        list itself is placed above the top of the stack before
  53.        the main program is entered, so there will be no inteference
  54.        with the main program's use of memory, except that somewhat
  55.        less will be available. (In my system a small program leaves
  56.        enough memory space to list 2500 file names.)
  57.  
  58.     8. The source code for WILD.CCC is in CCC.MAC and the include
  59.        file WILD.MAC. To prepare a new version:
  60.         In CCC.MAC, set WILDV to true, then
  61.         A>m80 =ccc
  62.         A>l80 wild.ccc/n,ccc/e
  63.  
  64.