Next: Structure Up: Standards and Tips Previous: Documentation

## Reference to Files

Different commands serve to read in existent files; for example loading and positioning of constructions, loading of drawing frames and title blocks or the interpreting of submacros, for example.

The user should avoid to save entire paths within a macro. For this purpose logical names (environments) should be created under operating system level and referenced with the help of the function GETENV.

e.g.

           LOAD DRAWING
              TCAT( GETENV("redenv") ; "/" ; "filename" ) !

With this procedure a data administration can be reorganized if necessary, without having to adapt all existent macros. In this case you may redirect the logical name and then the data will be read from the new path.

Documentation :

It is possible that a large number of macros is processed with special administration programs that have to be created.

To facilitate the task of such programs, we recommend to document the files used in the head of the macro.

The following syntax is assigned:

           \#$red     $redenv/filename
           \#$his     $makroenv/macroname      etc.

'#' marks a comment line.

'$red' and '$his' marks a hint to a drawing or a makro. Other extensions, which are set by the system, are also possible.

filename : either a full path name or a logical name.

It is also possible to assign one or more keys to the macro.

           \#$1  key
           \#$2  key   etc.

As already mentioned, such statements are intended for later evaluations. For the time being they have no meaning. If such statements are entered right from the beginning later extensions can be made much easier.