From 2b84823331e5db2f89d5b8ab6ac00a4447c34cf6 Mon Sep 17 00:00:00 2001 From: Ned Batchelder Date: Thu, 11 May 2023 07:35:21 -0400 Subject: docs: minor improvements to the migrating page --- doc/migrating.rst | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/doc/migrating.rst b/doc/migrating.rst index 996c19cb..5bbc1f33 100644 --- a/doc/migrating.rst +++ b/doc/migrating.rst @@ -7,26 +7,31 @@ Migrating between versions ========================== -New major versions of coverage.py might require you to adjust your settings, -options, or other aspects of your use. This page details those changes. +New versions of coverage.py or Python might require you to adjust your +settings, options, or other aspects how you use coverage.py. This page details +those changes. -.. _migrating_6x_7x: +.. _migrating_cov7: -Migrating from 6.x to 7.x -------------------------- +Migrating to coverage.py 7.x +---------------------------- -- The way that wildcards when specifying file paths work in certain cases has changed in 7.x: +Consider these changes when migrating to coverage.py 7.x: + +- The way that wildcards when specifying file paths work in certain cases has + changed in 7.x: - Previously, ``*`` would incorrectly match directory separators, making precise matching difficult. Patterns such as ``*tests/*`` will need to be changed to ``*/tests/*``. - - ``**`` now matches any number of nested directories. If you wish to retain the behavior of - ``**/tests/*`` in previous versions then ``*/**/tests/*`` can be used instead. + - ``**`` now matches any number of nested directories. If you wish to retain + the behavior of ``**/tests/*`` in previous versions then ``*/**/tests/*`` + can be used instead. - When remapping file paths with ``[paths]``, a path will be remapped only if - the resulting path exists. Ensure that remapped ``[paths]`` exist when upgrading - as this is now being enforced. + the resulting path exists. Ensure that remapped ``[paths]`` exist when + upgrading as this is now being enforced. - The :ref:`config_report_exclude_also` setting is new in 7.2.0. It adds exclusion regexes while keeping the default built-in set. It's better than -- cgit v1.2.1