bpo-27470: Improve doc for commandline -3 option

Mention that it warns about features that are significantly changed in Python 3
and can’t be detected using static code analysis.

Link to Porting Python 2 Code to Python 3 doc

diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
index b567818858f4f17c8ec4c2a24690a681c24e9b52..f00f7f6026a0febad21ea2ee559b35ce52433eab 100644 (file)
--- a/Doc/using/cmdline.rst
+++ b/Doc/using/cmdline.rst
@@ -417,10 +417,12 @@ Miscellaneous options
 
    Warn about Python 3.x possible incompatibilities by emitting a
    :exc:`DeprecationWarning` for features that are removed or significantly
-   changed in Python 3.
+   changed in Python 3 and can't be detected using static code analysis.
 
    .. versionadded:: 2.6
 
+   See :doc:`/howto/pyporting` for more details.
+
 Options you shouldn't use
 ~~~~~~~~~~~~~~~~~~~~~~~~~