Default compiler search path
By default, SC looks in the following places for class files:
- $PWD/SCClassLibrary OR $PREFIX/share/SuperCollider/SCClassLibrary
The installation step of the build process puts the class library in one of the standard places in $PREFIX, so a default installation should be ready to go. The library configuration file described below is mainly intended for more complex setups, possibly in a heterogenous multi-user environment.
Library Configuration FileBits and pieces of SC's class library can be in-/excluded by creating a library configuration file. A default configuration file is included in the distribution:
linux/examples/sclang.cfgIt should be copied to either /etc/sclang.cfg or ~/.sclang.cfg after installation. You can pass an alternative configuration file on the command line with the -l option. The search order for the library configuration is:
command line, $PWD/.sclang.cfg, $HOME/.sclang.cfg, /etc/sclang.cfgThe first valid file encountered is used.
Library Configuration File SyntaxThe library configuration file consists of simple directives of which files and directories to in-/exclude during the library compilation.
- A line starting with +, followed by a directory path includes the directory specified:
- A line starting with -, followed by a directory or file path, excludes the directory/file specified:
- A $ anywhere in the path followed by a shell variable identifier is substituted by the value of the environment variable specified. everything after a # at the beginning or end of a line is treated as a comment and consequently ignored:
# include my own library +$HOME/SuperCollider/Library
- A line starting with :, followed by a file path, includes the statements contained in the file specified in the library configuration: