diff --git a/doc/cabal-package.rst b/doc/cabal-package.rst
index c25290419bc7582c1640130b9cabe10e3bd551f7..2eadd56bd509d5f52d14e41782085d0eaed914b7 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