...CD]000READ.ME
----------------
Program:	CD.MAR V4.2 D_North 90.10.18
Author:		D.North, CCP
Date:		90.10.18
License:
    Ownership of and rights to these programs is retained by the author(s).
    Limited license to use and distrubute the software in this library is
    hereby granted under the following conditions:
      1. Any and all authorship, ownership, copyright or licensing
         information is preserved within any source copies at all times.
      2. Under absolutely *NO* circumstances may any of this code be used
         in any form for commercial profit without a written licensing
         agreement from the author(s).  This does not imply that such
         a written agreement could not be obtained.
      3. Except by written agreement under condition 2, source shall
         be freely provided with all executables.
      4. Library contents may be transferred or copied in any form so
         long as conditions 1, 2, and 3 are met.  Nominal charges may
         be assessed for media and transferral labor without such charges
         being considered 'commercial profit' thereby violating condition 2.

Warranty:
    These programs are distributed in the hopes that they will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
    or FITNESS FOR A PARTICULAR PURPOSE.

Description:
   CD is a simulation of an MSDOS/UNIX CD command with a large number of
   extensions.  Basic usage summary follows:

   DCL definition samples: (required to 'define' the CD command)
	$ CD:==$dev:[dir1.dir2]CD.EXE
	$ CD:==$dev:[dir1.dir2]CD.EXE/LOG

   Standard operations:
	CD				- give current dir
	CD ?				- generate brief help message
	CD #				- give previous dir
	CD $				- change to prev dir
	CD dirname			- change to subdir named
	CD .dirname			- change to subdir named
	CD \dirname			- change to root dir named
	CD dev:\dirname			- change to new device, root dir named
	CD ..				- move up one dir level
	CD ..\dirname			- move to adjacent dirname
	CD logical_dir			- move to spec'd directory logical
	CD logical_dir:			- move to spec'd directory logical
	CD dev:				- change to new dev same dir, not useful

   Personal identifiers (idents):
	CD IDN				- move to 'CDI_IDN' symbol contents

   Personal devices:
	CD FMT$:parm			- move to 'CDF_FMT$' symbol contents
                                          formatted $FAO using 'parm'
	CD FMT$:parm1.parm2...parm16	- move to 'CDF_FMT$' symbol contents
                                          formatted $FAO using 'parm1'..'parm16'

   Switches: (must be specified *BEFORE* pathname!!!)
	/LOG				- log changes in directory
	/VERIFY				- verify target dir... don't set def
	/FULL				- verbose messages

   Logical names used:
	LAST_DEFAULT_DIRECTORY		- always defined as last dir on ok
					  directory change

Useful hints:
   Personal device names override physical device names. Period.
   If you have an ident/logical conflict, use ':' for forcing logical usage.
   If you have a logical/subdirname conflict, use the '.name' to force
     subdirname usage instead of logical translation

Sample symbol definitions:
  $ CDI_R == "SYS$LOGIN:"
  $ CDI_M == "ZA1:[TEST_PROJECT.MAR]"
  $ CDF_R$ == "ZC1:[JOEUSER.!16(AS)]"
  $ CDF_P5$ == "PROJECT:[!AS.PROJ5.!15(AS)]"

Access examples for above sample symbol definitions:
  $ CD R
  $ CD
  ZC1:[JOEUSER]
  $ CD M
  $ CD
  ZA1:[TEST_PROJECT.MAR]
  $ CD R$:PRIVATE.WORK.FILES
  $ CD
  ZA1:[JOEUSER.PRIVATE.WORK.FILES]
  $ CD P5$:ALARM.VER1.WORK
  $ CD
  PROJECT:[ALARM.PROJ5.VER1.WORK]