bpo-33095: Add reference to isolated mode in -m and script option

[tirkarthi]

• Add reference to isolated mode in -m and <script> option
• Make - and <script> hyperlinkable. I couldn't get this working using label definitions in markdown. I read through cross-linking markup but it seems that adding it increases the font and makes the section as 1.2 . Maybe I am missing something here due to my limited knowledge

Ref for hyperlinking : https://bugs.python.org/msg319812

https://bugs.python.org/issue33095

Thanks

https://bugs.python.org/issue33095

[zooba]

Is it possible the : at the end of the name is not necessary and that is what's affecting the font?

[tirkarthi]

Can you be little more specific on affecting the font part? On removing : at the end I get /home/cpython/Doc/using/cmdline.rst:127: WARNING: malformed hyperlink target. . To be honest my knowledge on Sphinx markdown is low. I took this syntax as an exact copy from https://bugs.python.org/issue33095#msg319812 . I was trying to make them hyperlinks so that they can be referenced I might be wrong on the syntax here.

Thanks

[tirkarthi]

Initially I was trying out .. cmdoption:: - and .. cmdoption:: script removing describe:: which works fine but there was an explicit note on the bpo message to use .. _cmdarg-dash: so that they are hyperlinkable like option ones without looking the same.

For making "-" and "<script>" hyperlinkable, you'll need to add a label definition to the Sphinx source code immediately before those description sections. I'd suggest ".. _cmdarg-dash:" and ".. _cmdarg-script:" so the resulting anchors look similar to the option ones, without being the same.

[vstinner]

I removed the " needs backport to 3.6" label, the 3.6 branch no longer accept bugfixes (only security fixes are accepted): https://devguide.python.org/#status-of-python-branches

[bedevere-bot]

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

[tirkarthi]

I have made the requested changes; please review again

[bedevere-bot]

Thanks for making the requested changes!

@JulienPalard: please review the changes made to this pull request.

[miss-islington]

Thanks @tirkarthi for the PR, and @ncoghlan for merging it 🌮🎉.. I'm working now to backport this PR to: 3.7.
🐍🍒⛏🤖

[miss-islington]

Sorry, @tirkarthi and @ncoghlan, I could not cleanly backport this to 3.7 due to a conflict.
Please backport using cherry_picker on command line.
cherry_picker bdd6945d4dbd1fe6a7fcff95f7d6908db7d791a1 3.7

[miss-islington]

Thanks @tirkarthi for the PR, and @ncoghlan for merging it 🌮🎉.. I'm working now to backport this PR to: 3.8.
🐍🍒⛏🤖

[bedevere-bot]

GH-16180 is a backport of this pull request to the 3.8 branch.

[bedevere-bot]

GH-16181 is a backport of this pull request to the 3.7 branch.

[JulienPalard]

Thanks @tirkarthi!