Default compiler search path
By default, SC looks in the following places for class files:
- $PWD/SCClassLibrary OR $PREFIX/share/SuperCollider/SCClassLibrary
- $PREFIX/share/SuperCollider/Extensions
- $HOME/share/SuperCollider/Extensions
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 File
Bits 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 Syntax
The 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:
+/path/to/my/directory
- A line starting with -, followed by a directory or file path, excludes the directory/file specified:
-/dont/include/this/file.sc -/leave/that/directory/alone
- 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:
:$HOME/.sclang.scel.cfg