How to freeze - #9984

Draft

philderbeast wants to merge 61 commits into

haskell:masterfrom

cabalism:docs/freeze-brrgh

Commits on Jul 25, 2026

Improved docs on cabal freeze.

Martinsos
authored and
philderbeast
committed
d8d0601
Move freeze discussion to guide
philderbeast
committed
d9d42a4
Typo continuos
philderbeast
committed
bdd063e
Use description list for common workflows
philderbeast
committed
f08fc4f
Define what freezing is
philderbeast
committed
61e6575
Move freezing downwards in the guide
philderbeast
committed
8747754
Extra .freeze extension
philderbeast
committed
471960a
Add a dependency then freeze harder
philderbeast
committed
2f74166
Do you need to freeze as new section title
philderbeast
committed
6f1a209
How to control versions
philderbeast
committed
35d5db3
Add other ways to control versions
philderbeast
committed
92cdfd9
Add section titles
philderbeast
committed
79fc790
Stackage as a curated package set
philderbeast
committed
60033e6
Constraints are additive
philderbeast
committed
2f883d2
Add version ranges
philderbeast
committed
94c984f
Add content to the version ranges section
philderbeast
committed
5fea03c
Add version constraints and exceptions
philderbeast
committed
3752941
Demo of --with-compiler effect
philderbeast
committed
7b77f74
Typo, not matter

philderbeast
and
langston-barrett
committed
dfb39df
Redo the freezing workflows
philderbeast
committed
440ba51
Satisfy whitespace
philderbeast
committed
c032611
Typo s/chose its/choose a/

philderbeast
and
langston-barrett
committed
e70276b
Typo s/This is/This/

philderbeast
and
langston-barrett
committed
b74cd62
Add mandatory version constraints
philderbeast
committed
60a7fef
Warn about reject-unconstrained
philderbeast
committed
5f7902b
Versions and flags

philderbeast
and
Bodigrim
committed
3db307e
Add LTS and nightly package set examples
philderbeast
committed
b0789ea
Add a ref to curated version sets
philderbeast
committed
8dd1ea3
Add ref links from definition list to sections
philderbeast
committed
c90e11b
Use directory as example of flags changing deps
philderbeast
committed
2528df5
Add example of missing upper bound on base
philderbeast
committed
d2601d8
Say the order is worse to better
philderbeast
committed
93962f6
Move mandated versions to its own section
philderbeast
committed
633bf32
Add a section, places for versioning
philderbeast
committed
c0c4c9c
Demote to note, order of .freeze and .local
philderbeast
committed
3e0f2ac
Use .project and .config extensions in general
philderbeast
committed
200129c
Move lib versus exe .freeze distribution
philderbeast
committed
b2028e7
Revert cabal freeze command
philderbeast
committed
ef291c8
Add an example of hackage dependencies
philderbeast
committed
bdfdb87
Typo, commit to *the* version control

philderbeast
and
geekosaur
committed
454332d
Typo the solver is *let* free

philderbeast
and
geekosaur
committed
8c05f9f
Bold short descriptions and ref to freeze-harder
philderbeast
committed
01735c2
New introductory sentence for adding a dep
philderbeast
committed
f145e04
Add a tip for different compiler versions
philderbeast
committed
603af1d
Link to "with-compiler" and "project-file"
philderbeast
committed
b777b86
Satisfy fix-whitespace
philderbeast
committed
7e85b81
Misplaced semicolon
philderbeast
committed
ccdfae8
Remove unneeded semicolon
philderbeast
committed
2782b84
Say a lot more about accumulating constraints
philderbeast
committed
4081718
Limitations of cabal freeze
philderbeast
committed
c9c1470
Not a true lock file
philderbeast
committed
b1d79f7
When to commit a freeze file to source control
philderbeast
committed
9918224
Add a "Freezing limitations" section
philderbeast
committed
1f08f41
Add a limitations section
philderbeast
committed
d97acd7
Split into avoiding and setting lists
philderbeast
committed
0fdb35f
Variation on avoiding and setting
philderbeast
committed
80a9fb5
Satisfy whitespace
philderbeast
committed
ad40055
Change warning to tip for reject-unconstrained-*
philderbeast
committed
e9d3300
A freeze file does not block adding new deps
philderbeast
committed
ad9971e
Add TODOs for .local and .freeze loading
philderbeast
committed
e9c06df
Don't describe .local and .freeze as quirky
philderbeast
committed
934a122