From 65f13c74166529bfe50dbb52aa4c4274882a3b65 Mon Sep 17 00:00:00 2001 From: Andreas Abel Date: Sat, 25 Feb 2023 01:51:45 +0100 Subject: [PATCH] Fix #8756: doc: `extra-source-files` are tracked by `cabal build` (#8765) Changing a file from `extra-source-files` causes `cabal build` to reevaluate the build plan, judging from the following behavior. ```console $ cabal build ... $ cabal build Up to date # Make a change to any of the extra-source-files, e.g. Foo.txt $ cabal build ... In order, the following would be built (use -v for more details): - ... (lib) (file Foo.txt changed) ... ``` One notes here that the 3rd `cabal build` does not just output "Up to date". Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com> (cherry picked from commit fdcf77b2e6d70a665ef4c2fc0c08bd850ab8114b) --- doc/cabal-package.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/cabal-package.rst b/doc/cabal-package.rst index c25290419bc..2eadd56bd50 100644 --- a/doc/cabal-package.rst +++ b/doc/cabal-package.rst @@ -774,9 +774,9 @@ describe the package as a whole: .. pkg-field:: extra-source-files: filename list - A list of additional files to be included in source distributions - built with :ref:`setup-sdist`. As with :pkg-field:`data-files` it can use - a limited form of ``*`` wildcards in file names. + A list of additional files to be included in source distributions built with :ref:`setup-sdist`. + As with :pkg-field:`data-files` it can use a limited form of ``*`` wildcards in file names. + Files listed here are tracked by ``cabal build``; changes in these files cause (partial) rebuilds. .. pkg-field:: extra-doc-files: filename list :since: 1.18