1 CPL CPL[/global_switches] filename[/local_switches][,filename...][>commandfile] global_switches Switches applied to each filename. local_switches Switches applied to the filename they modify. Certain switches are recognized and processed by CPL. ** Type 'HELP CPL SWITCHES' for information about these switches. All other switches are passed on to the compiler. ** filename Standard file specification. May not include device, directory, extension or version fields. ** >[>]commandfile Direct compilation commands to a file. CPL will select the proper compiler to compile a given file. It will only compile that file if the source post-dates the object file or if the object file does not exist. CPL is very useful for building programs consisting of many modules since if one of the modules(files) is edited CPL will only compile that file. 2 Switches Special switches recognized by CPL: /List Produce a compiler listing on filename.lst. /Print Produce a compiler listing on the printer. /Nobject Don't produce an object file. (implies /force) /Force Force compilation. /Keep Keep all output from multi-pass compilers. /Symbols Include default symbol file for RATFOR. /Xternal Allow external procedures for NBS PASCAL. /Integer Use integer arithmetic for C floating point. ** /Build[:file+file...] Produce a link command file for BASIC+2. Type 'HELP CPL BUILD' for information. /LIBr:libraryname Update the library (libraryname) with any files that were compiled. 2 Build CPL/BUILD FILE1,FILE2 The name 'FILE1.BLD' will be used to name the command file. All files on the command line will be included in the link. CPL/BUILD:SUBR1+SUBR2 FILE1,FILE2 If the file arguments are included on the build switch these files will be included in the link but not compiled. These files may contain device, directory, extension and version fields @FILE1.BLD This command will link your program. N.B. The /BUILD switch only applies to BASIC+2. The overlay description file produced by BASIC+2 will be modified by CPL to build your program unoverlayed and more quickly. 2 Filename CPL FILE1+FILE2+FILE3 If a '+' is used between files, those files will be concatenated before compilation. The last file in the list will be used for the object and listing file names. All files in the list will be date checked against the object file to determine if the files need compilation. Files in the concatenation list may contain extensions. If no extension is supplied the default compiler extension will be used. Compiler Default extension -------- ------- --------- FORTRAN 4+ .FTN MACRO .MAC BASIC +2 .B2S RATFOR .RAT NBS PASCAL .PAS SWEDISH PASCAL .SPA C .C 2 Commandfile CPL/LIST FILE>FILE.CMD CPL will direct all commands to a file rather than execute them. CPL/LIST FILE>>FILE.CMD CPL will append all commands to a file.