Welcome to the Cabal User Guide

Getting Started

• 1. Getting Started
  • 1.1. Installing Cabal
  • 1.2. Creating a new application
  • 1.3. Running a single-file Haskell script
  • 1.4. What Next?

Cabal Guide

• 1. How to package Haskell code
  • 1.1. Introduction
  • 1.2. Using cabal init
  • 1.3. Running the program
  • 1.4. About the Cabal package structure
  • 1.5. Editing the .cabal file
  • 1.6. Modules included in the package
  • 1.7. Modules imported from other packages
  • 1.8. Building the package
• 2. How to build locally like in Nix
  • 2.1. Quickstart
  • 2.2. Cookbook
  • 2.3. How it works
• 3. How to use Cabal in Windows
  • 3.1. Install the Haskell environment
  • 3.2. Ensure that Cabal can call the tools it needs
  • 3.3. Ensure that Cabal can use system libraries
  • 3.4. Ensure that Cabal can call Haskell tools
  • 3.5. Complete configuration
  • 3.6. Further reading
• 4. How to use Backpack modules
• 5. How to report Cabal bugs and feature requests

Cabal Reference

• 1. Package Description — <package>.cabal File
  • 1.1. Creating a package
  • 1.2. Package descriptions
  • 1.3. Custom setup scripts
  • 1.4. Autogenerated modules and includes
  • 1.5. Accessing data files from package code
  • 1.6. System-dependent parameters
  • 1.7. Conditional compilation
  • 1.8. More complex packages
• 2. Project Description — cabal.project File
  • 2.1. Conditionals and imports
  • 2.2. Specifying the local packages
  • 2.3. Global configuration options
  • 2.4. Phase control
  • 2.5. Solver configuration options
  • 2.6. Package configuration options
  • 2.7. Advanced global configuration options
• 3. cabal-install Configuration and Commands
  • 3.1. Configuration
  • 3.2. Commands
• 4. External Commands
• 5. Setup.hs Commands
  • 5.1. Building and installing a system package
  • 5.2. Creating a binary package
  • 5.3. runhaskell Setup.hs configure
  • 5.4. runhaskell Setup.hs build
  • 5.5. runhaskell Setup.hs haddock
  • 5.6. runhaskell Setup.hs hscolour
  • 5.7. runhaskell Setup.hs install
  • 5.8. runhaskell Setup.hs copy
  • 5.9. runhaskell Setup.hs register
  • 5.10. runhaskell Setup.hs unregister
  • 5.11. runhaskell Setup.hs clean
  • 5.12. runhaskell Setup.hs test
  • 5.13. runhaskell Setup.hs bench
  • 5.14. runhaskell Setup.hs sdist
• 6. Package Description Format Specification History
  • 6.1. cabal-version: 3.12
  • 6.2. cabal-version: 3.8
  • 6.3. cabal-version: 3.6
  • 6.4. cabal-version: 3.4
  • 6.5. cabal-version: 3.0
  • 6.6. cabal-version: 2.4
  • 6.7. cabal-version: 2.2
  • 6.8. cabal-version: 2.0
  • 6.9. cabal-version: 1.24
  • 6.10. cabal-version: 1.22
  • 6.11. cabal-version: 1.20
  • 6.12. cabal-version: 1.18
  • 6.13. cabal-version: 1.16
  • 6.14. cabal-version: 1.12
• 7. Field Syntax Reference
  • 7.1. Notation
  • 7.2. Lists
  • 7.3. Non-terminals
  • 7.4. Build info fields
  • 7.5. Package description fields
  • 7.6. Test-suite fields

Cabal Explanation

• 1. What Cabal does
  • 1.1. A tool for working with packages
  • 1.2. What’s in a package
  • 1.3. Cabal featureset
  • 1.4. Similar systems
• 2. Package concepts
  • 2.1. The point of packages
  • 2.2. Package names and versions
  • 2.3. Kinds of package: Cabal vs GHC vs system
  • 2.4. Unit of distribution
  • 2.5. Explicit dependencies and automatic package management
  • 2.6. Portability
• 3. Stability of Cabal interfaces
  • 3.1. Cabal file format
  • 3.2. Command-line interface
  • 3.3. Functions and Types
  • 3.4. Hackage