Next:
Contents
 
Contents
CM
The SML/NJ Compilation and Library Manager
(for SML/NJ version 110.35 and later)
User Manual
Matthias Blume
Lucent Technologies, Bell Labs
Contents
1. Introduction
2. The CM model
2.1 Basic philosophy
2.2 Description files
2.3 Invoking CM
2.4 Members of a library
2.5 Name visibility
2.6 Library components (groups)
2.7 Multiple occurences of the same member
2.8 Stable libraries
2.9 Top-level groups
2.10 Proxy libraries
3. Naming objects in the file system
3.1 Motivation
3.2 Basic rules
3.3 Anchor environments
3.4 Anchor configuration
3.5 When to use anchor environments
4. Using CM
4.1 Structure CM
4.1.1 Compiling
4.1.2 Linking and execution
4.1.3 Registers
4.1.4 Path anchors
4.1.5 Setting CM variables
4.1.6 Library registry
4.1.7 Internal state
4.1.8 Compile servers
4.1.9 Plug-ins
4.1.10 Support for stand-alone programs
4.1.11 Finding all sources
4.2 The autoloader
4.3 Sharing of state
4.3.1 Sharing annotations
4.3.2 Sharing with the interactive system
5. Version numbers
5.1 How versions are compared
5.2 Version checking
6. Member classes and tools
6.1 Tool parameters
6.1.1 Parameters for class
sml
6.1.2 Parameters for class
cm
6.1.3 Parameters for classes
tool
and
suffix
6.2 Built-in tools
6.2.1 ML-Yacc
6.2.2 ML-Lex
6.2.3 ML-Burg
6.2.4 Shell
6.2.5 Make
6.2.6 Noweb
6.2.7 Dir
6.2.7.1 Directory factoring:
6.2.7.2 Directory scanning:
7. Conditional compilation
7.1 CM variables
7.2 Querying exported definitions
7.3 Explicit errors
8. Access control
9. The pervasive environment
10. Files
10.1 Time stamps
10.2 Index files
11. Extending the tool set
11.1 Adding simple shell-command tools
11.2 Adding other classes
11.2.1 Filename abstractions
11.2.2 Adding a class and its rule
11.2.3 Reporting errors from tools
11.2.4 Adding a classifier
11.2.5 Miscellaneous
11.3 Plug-in Tools
11.3.1 Automatically loaded, global plug-in tools
11.3.2 Explicitly loaded, local plug-in tools
11.3.3 Locally declared suffixes
12. Parallel and distributed compilation
12.1 Pathname protocol encoding
12.2 Parallel bootstrap compilation
13. The
sml
command line
13.1 File arguments
13.2 Mode-switching flags
13.3 Defining and undefining CM preprocessor symbols
14. Auxiliary scripts
14.1 Building stand-alone programs
14.1.1 Bootstrapping: How
ml-build
works
14.2 Generating dependencies for
make
15. Example: Dynamic linking
16. Some history
A. CM description file syntax
A..1 Lexical Analysis
A..2 EBNF for preprocessor expressions
A..3 EBNF for export lists
A..4 EBNF for tool options
A..5 EBNF for member lists
A..6 EBNF for library descriptions
A..7 EBNF for library component descriptions (group descriptions)
B. Full signature of
structure CM
C. Listing of all pre-defined CM identifiers
D. Listing of all CM-specific environment variables
E. Listing of all class names and their tools
F. Available libraries
F..1 Libraries for general programming
F..2 Libraries for controlling SML/NJ's operation
F..3 Libraries for SML/NJ compiler hackers
F..4 Internal libraries
G. Exports of library
$smlnj/cm/tools.cm
G..1 The public signature of
structure Tools
G..2 The public signature of
structure Version
G..3 The public signature of
structure Sharing
Bibliography
About this document ...
Matthias Blume
2001-07-19