====== Compilation Directives ======


===== ;$INCLUDE  =====
 
Source files can be included from other source files. This is accomplished with a compiler directive in a comment like this:  

     ;$INCLUDE:FILESPEC.EXT

Note that the first character need not be the semi-colon. An apostrophe ['] or asterisk [*] may also be used where appropriate.  

This allows you to include subroutines from a source code 'library'. This should help in starting reusable code fragments. When the file is included, it is compiled as though it were in the main source file. 

**For example:**  

     FOO.INC  
     -------  
     :subroutine  
     PRINTLN "Hello!"  
     RETURN  

     FOO.PPS  
     -------  
     PRINTLN "Running FOO.PPS"  
     GOSUB subroutine  
     END ' This line is important!  
     *$INCLUDE:FOO.INC  

Note the use of END in FOO.PPS. It is important in this case to ensure that you don't accidentally run subroutine twice by just falling through to it.  

===== ;$USEFUNCS =====
Allow you to specifiy that you want to use user-defined functions and  procedures.  

This makes the code more flexible by allowing you to put your main code (code between Begin and End) anywhere in your program (usefull if you have to incude some user-defined functions with an include directive at the  beginning of your code)

----
**Tags:** {{tag>ppl}}