Skip to content

Commit

Permalink
Reword the note
Browse files Browse the repository at this point in the history
  • Loading branch information
philderbeast committed Oct 30, 2023
1 parent 46321d8 commit a809e03
Showing 1 changed file with 9 additions and 7 deletions.
16 changes: 9 additions & 7 deletions doc/cabal-package.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1481,13 +1481,15 @@ system-dependent values for these fields.

.. Note::

To avoid package versions when there is no `not equal` operator, use
``<`` and ``>`` in combination with the ``||`` operator. We might want to
do this to avoid a deprecated version or to skip versions. For example,
the `time =1.12.*` series depends on `base >=4.13 && <5` but
`time-1.12.3` bumps the lower bound on base to `4.14`. If we still want
to compile with a `ghc-8.8.*` version of GHC that ships with `base-4.13`,
then we can use `time >=1.12 && (time <1.12.3 || time >1.12.3)`.
Even though there is no `not equal` operator, by combining ``<`` and
``>`` with ``||``, we can skip over one or more versions.

We can skip a deprecated version or we can skip versions that upset the
solver. For example, the `time =1.12.*` series depends on `base >=4.13
&& <5` but `time-1.12.3` bumps the lower bound on base to `4.14`. If we
still want to compile with a `ghc-8.8.*` version of GHC that ships with
`base-4.13`, then we can use `time >=1.12 && (time <1.12.3 || time
>1.12.3)`.

If no version constraint is specified, any version is assumed to be
acceptable. For example:
Expand Down

0 comments on commit a809e03

Please sign in to comment.