Reference
Complete reference documentation for Sigil.
Language Reference
Detailed coverage of Sigil language constructs (see Standard Library):
- Syntax - Expressions, literals, quoting, comments
- Special Forms - Definitions, bindings, conditionals, iteration
- Modules - Library definition, imports, exports
- Macros - syntax-rules, syntax-case, hygiene
- Records - define-struct, define-record-type
- Exceptions - guard, raise, exception types
Style Guide
Conventions for writing idiomatic Sigil code (see Standard Library):
- Naming - Predicates, mutators, conversions, constants
- Formatting - Indentation, parentheses, line length
- Idioms - Common patterns and best practices
- Documentation - Docstring format and conventions
Tools
CLI Reference
Complete documentation for the sigil command-line tool.
REPL Reference
Interactive development with the Sigil REPL, including commands, debug mode, and nREPL protocol.
Build Cache and Store
Content-addressed build caching, store locations, and automatic read-only sandbox overlays.
Package File
The package.sgl file format for defining package metadata, dependencies, and build configuration.
Compatibility
R7RS Compatibility
What R7RS features Sigil supports, what's intentionally omitted, and porting tips from other Schemes.
Language Reader Protocol v1
The frozen contract for package-resolved #lang readers that turn alternate source notation into located Sigil syntax.
Quick Links
| Topic | Section |
|---|---|
| Running programs | CLI: Running Files |
| REPL usage | CLI: REPL |
| Special forms | Special Forms |
| Module definition | Modules |
| Defining structs | Records |
| Error handling | Exceptions |
| Project setup | Package File |
| Build cache | Build Cache and Store |