Skip to content

Commit a379fb6

Browse files
Don't use lists in footnotes (#11378)
- Number the point sentences - Use first, next and finally - Replace .using Nix-style with with etc - Replace it with build-depends - Use code style for build-depends Co-authored-by: Artem Pelenitsyn <a.pelenitsyn@gmail.com>
1 parent 3b433f5 commit a379fb6

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

doc/cabal-package-description-file.rst

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3455,8 +3455,10 @@ a few options:
34553455
.. rubric:: Footnotes
34563456
34573457
.. [#old-style-build-tool-depends]
3458-
Some packages (ab)use :pkg-field:`build-depends` on old-style builds, but this has a few major drawbacks:
3459-
3460-
- using Nix-style builds it's considered an error if you depend on a exe-only package via build-depends: the solver will refuse it.
3461-
- it may or may not place the executable on ``PATH``.
3462-
- it does not ensure the correct version of the package is installed, so you might end up overwriting versions with each other.
3458+
Some packages (ab)use :pkg-field:`build-depends` on old-style builds, but
3459+
this has a few major drawbacks. First, with Nix-style builds it's considered
3460+
an error if you depend on a exe-only package via ``build-depends``: the
3461+
solver will refuse it. Next, ``build-depends`` may or may not place the
3462+
executable on ``PATH``. Finally, ``build-depends`` does not ensure the
3463+
correct version of the package is installed, so you might end up overwriting
3464+
versions with each other.

0 commit comments

Comments
 (0)