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 e8bcd34
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 e8bcd34

Please sign in to comment.