CV) Details concerning the DESL
autopathfile command.Assigns or toggles the active state of or edits a globally available DESL pathfile type file, similar to those already referenceable in association with many DESL commands.
Please see the typical "pathfile" documentation in the DESL copy command.
If a file name of up to 64 characters (if more than 16 characters, enclose long string in question marks, ?...?) follows this command, on the same line, then this file is copied to a special working pathfile file that will be available within each command to use for path string redirection. Just as a command's "pathfile" file is used to translate a shorter string into a longer string for the purposes of defining a full, legitimate file path name prefix, an autopathfile file is used BEFORE, but possibly AFTER, any specified "pathfile" file per command to try to match shorter path strings if a match was not found in a specified pathfile file.
In all cases a pathfile must be used in conjunction with the "paths" option specified for a command. If, immediately after "autopathfile", the word after is specified, then the named autopathfile file name will be looked at after the contents of a command-specific "pathfile" option, if one is specified. If no "pathfile" option is specified for a command, the "autopathfile" file's contents will be the ONLY such that be referenced.
The contents of an "autopathfile" file are actually copied to an internal working file before they are used. All editing that is possible on the autopathfile file is actually done to the working copy of the original autopathfile file. Only when the "export" is done (see below) can the working file contents be transferred back to a normal external file.
The contents of the lines making up an autopathfile file look like :
* comment line
*
* 2 columns per line
*
* Left col : up to 16 characters : short_path (to match)
*
* Right col : up to 64 characters,
* enclosed in ? ... ? : long_path
*
* short_path less_than_16
* short_path ?up_to_64_ch ar_path_name? ;
*
* comment line
*
P1 ?c:\user\tes t12=group13\? ;
a ?c:\path2\su b_path3\sub-sub_ path1\?
If, after "autopathfile", instead of a file name, or "before" followed by a file name, a secondary argument "off" or "on" is specified, DESL will be put into a mode in which it pays attention to the current working "autopathfile" file ("on") or ignores this file ("off") during the processing of DESL commands.
There are additional arguments that may follow "autopathfile" on the same line which can indicate that editing of the working autopathfile file is to occur.
The possible arguments and their syntax and meanings are in the following summary of all possible "autopathfile" arguments :
autopathfile (after) FN : sets FN as file to populate working autopath file. If "after" also specified, the autopathfile file will be used AFTER any "pathfile" path file used. The default situation is to use an autopathfile file before any "pathfile" path file used.
autopathfile off : ignore the working autopathfile file
autopathfile on : begin paying attention to the working autopathfile
autopathfile export (FN) : defines the file to receive the working autopath file contents. The default file name will be the (last) original autopathfile file name specified.
autopathfile [dir] : specify editing directive
where, (dir) : one of a menu of editing directives to modifiy the contents of a working copy of the autopathfile file. If no autopathfile file nas been named, initially, only the "insert" editing directive will have meaning.
Possible directives :
1. c(lear)
All lines will be removed from the working autopathfile file
.
2. d(elete) short_path
If a line containing the short_path name in the left column exists, then it will be deleted from the working autopathfile file. If the short_path string is NOT found, nothing is done.
3. r(eplace) short_path long_path
If a line containing the short_path name in the left column exists, then that entriy's right-hand column will be replaced with the long_path name specified in the working autopathfile file. If the short_path string is NOT found, nothing is done.
4. r(eplace)i short_path long_path
If a line containing the short_path name in the left column exists, then that entriy's right-hand column will be replaced with the long_path name specified in the working autopathfile file. If the short_path is NOT found, the directive reverts to the equivalent "insert" directive.
5. i(nsert) (top | before | after short_path)
short_path long_path
Insert a new entry in the working autopathfile file at the location specified (or default location = at end). No check is made to see if the entry already exists. The "before" and "after" location implicators take a second argument to establish a reference location. If the desired line cannot be located the new entry is added at the end. Only the first occurrence of the short_path string to be located will be used.
DESL Manager at ViGYAN, Inc.
30 Research Drive
Hampton, VA 23666
Voice: (757) 865-1400
Toll Free: (800) 288-3998
FAX: (757) 865-8177
