Skip to content

Commit 32b8ac7

Browse files
committed
Re #6944 Alternative approach to docs for --force-dirty flag
1 parent bffd84d commit 32b8ac7

1 file changed

Lines changed: 10 additions & 11 deletions

File tree

doc/commands/build_command.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -339,23 +339,22 @@ Default: Disabled
339339

340340
A package that is unchanged from when it was last built by Stack is said to be
341341
_clean_ and _dirty_ means the opposite. Set the flag to force the rebuild of
342-
packages that could, in principle, be dirty (such as
343-
[project packages](../configure/yaml/project.md#packages) or local file
344-
path [extra-deps](../configure/yaml/project.md#extra-deps)) even when it does
345-
not seem necessary based on file dirtiness.
342+
local packages ([project packages](../configure/yaml/project.md#packages) or
343+
local file path [extra-deps](../configure/yaml/project.md#extra-deps)) even when
344+
it does not seem necessary based on file cleanliness.
346345

347346
!!! note
348347

349-
The flag `--force-dirty` has no effect if packages to be built do not
350-
include any that could, in principle, be dirty. Packages that are deemed
351-
immutable (unchanging) by Stack cannot, in principle, be dirty.
348+
The flag `--force-dirty` has no effect if no local packages would be built.
349+
Packages that Stack deems immutable (unchanging) cannot, in principle, be
350+
dirty.
352351

353352
There may be circumstances in which you wish Stack to rebuild an installed
354353
Haskell package (one registered in the relevant package database) that is
355-
deemed immutable. For example, if that package has a dependency on a C
356-
library that has, in fact, changed since the package was registered. To
357-
cause Stack to try to rebuild such a package, first unregister it from the
358-
package database by commanding:
354+
deemed immutable. For example, if it has a dependency on a C library that
355+
has, in fact, changed since the package was registered. To cause Stack to
356+
try to rebuild such a package, first unregister it from the package database
357+
by commanding:
359358

360359
~~~text
361360
stack exec -- ghc-pkg unregister --force <package>

0 commit comments

Comments
 (0)