Merge pull request #11952 from ffaf1/fix-doc-buildinfo

Clarify `.buildinfo` precedence

Author: mergify[bot]

doc/cabal-package-description-file.rst

@@ -3210,10 +3210,11 @@ The :pkg-field:`build-type` ``Configure`` differs from ``Simple`` in two ways:
 -  If the package root directory contains a file called
    *package*\ ``.buildinfo`` after the configuration step, subsequent
    steps will read it to obtain additional settings for `build
-   information`_ fields,to be merged with the ones
-   given in the ``.cabal`` file. In particular, this file may be
-   generated by the ``configure`` script mentioned above, allowing these
-   settings to vary depending on the build environment.
+   information`_ fields.  ``.buildinfo`` settings will be merged with
+   ``.cabal`` file ones, the former taking precedence over the latter.
+   The ``.buildinfo`` file may be generated by the ``configure`` script
+   mentioned above, allowing these settings to vary depending on the
+   build environment.
 
 Note that the package's ``extra-source-files`` are available to the
 ``configure`` script when it is executed. In typical ``autoconf`` fashion,