DESL

DESL Home | Website Outline | Commands | Examples | Download | Contacts

( BH) Details concerning the DESL macrolib command.

(See example(s) of the use of the macrolib command.)
[Jump to the list of available options.]
General description of the macrolib command :

The "macrolib" command provides the capability to the user to add/remove macros to/from the current DESL session. If macros are being added, the file(s) from which they come must already be in existence and must be of the correct syntax. (See the discussion of Macros for examples of macro files.)

The list of currently available options for the macrolib command is the following.

Any blinking names enclosed in brackets are required or are in a set of options, one of which must be specified. Any non-blinking names enclosed in brackets are optional or are in a set of options, only one of which can be specified.

In cases where the option name is one of a set each different set number is indicated by a red numeric set number superscript trailing the respectiveright bracket :

[edit] [elsek] [endifk] [files]1 [ifk] [pathfile] [paths] [remove]1

[Top][Bottom][Option list]

( BHedit) (Command :macrolib) Details for the edit option.

[General syntax rules for this keyword.]

Indicates that the macros being referenced are to be edited before they are installed. Only an available option when DESL is being executed interactively.

[Top][Bottom][Option list]

( BHfiles) (Command :macrolib) Details for the files option.

[General syntax rules for this keyword.]

Indicates the names of the files to examine for valid DESL macros. All valid macros found in each file will be installed up to the cumulative session limit of 100. File names can also include the {...} construct. This type specification within a file name implies that the list name given between the curly brackets ( {} ), is to be used to have each of its elements substituted in turn for the { ... }, inclusively, such that an implicit lengthening of the file list is accomplished, up to the maximum number of files allowed. Any time such a {...} usage occurs, all lists mentioned must exist; i.e., must have been previously defined in the current DESL session. Only one {...} construct can be included in a file name. Including more than one such construct will result in unpredictable results.

An example of this type of file name specification is the following :

t43r{runs}.sif

Here, the list "runs" will have its elements used, in turn, in place of the {runs} substring.

.

(Begin modifications on 052102)

Each file name, whether it includes the {...} or not, can be a maximum of 256 characters long. If a file name is more than 16 characters long it must be enclosed in question marks (?) .

(End modifications on 052102)

UP to 100 file names can be specified.

Example : files macro1 macro2

[Top][Bottom][Option list]

( BHpathfile) (Command :macrolib) Details for the pathfile option.

[General syntax rules for this keyword.]

If specified, any up-to-16-charact string specified via the "paths" option and argument list can be translated to an up-to-64-charact string. If a specified "paths" string matches a string in the left column in the path file, then the (potentially longer) string in the right column in the same line in the path file is substituted for the original string. The rules for the syntax of a path file are the following :

  1. all lines are ASCII
  2. any line beginning with "* " is a comment and is ignored (asterisk + one or more blanks)
  3. blank lines are ignored
  4. only 2 items per line per translation : the first up to 16 characters and the second up to 64 characters. Any string longer than 16 characters MUST be enclosed in question-mark (?) delimiters.
  5. free-field interpretation, therefore embedded blanks require the "?" delimiters
  6. first item is name to be translated; must match VERBATIM with path name specified or implied via "paths" argument list
  7. second item is the corresponding path name translation

An example of such a file is the following : 



*
*  Example path file for test xxx
*
*  item  1 = path to be translated : MUST
*             match VERBATIM with name given
*             specified/implied via "paths"
*
*  item  2 = resulting name translation
*
data56    ? \usr\home2\ people\test56\ ?
up  ?..\?
way-up  ? ..\..\..\ Temp46\?

Example : pathfile pathA

[Top][Bottom][Option list]

( BHpaths) (Command :macrolib) Details for the paths option.

[General syntax rules for this keyword.]

Indicates, in a 1:1 correspondence with the list of files specified, directory locations for the specified files. These locations supersede the current directory. If a file location thus specified is not empty ("null...") a search for the respective file will be made at the indicated location before a search is made at any other alternate locations which have been made effective via a previous execution of the "path" command. By default, all path names are blank. Up to 100 path names can be specified.

Example : paths ..\ ..\Main\ sub1\

[Top][Bottom][Option list]

( BHremove) (Command :macrolib) Details for the remove option.

[General syntax rules for this keyword.]

Indicates the names of macros, which if installed, are to be removed from the current DESL session. Up to 100 macro names can be specified.

Example : remove mac12 betaderiv

[Top][Bottom][Option list]

DESL Home | Website Outline | Commands | Examples | Download | Contacts



ViGYAN, Inc.

DESL Manager at ViGYAN, Inc.

30 Research Drive
Hampton, VA 23666
Voice: (757) 865-1400
Toll Free: (800) 288-3998
FAX: (757) 865-8177

© 1998 ViGYAN, Inc.