[Python-checkins] cpython (3.4): Issue #12602: Add missing cross-references to runpy and using/cmdline docs.
berker.peksag
python-checkins at python.org
Wed Dec 10 00:47:41 CET 2014
https://hg.python.org/cpython/rev/bd14c4e5ef00
changeset: 93795:bd14c4e5ef00
branch: 3.4
parent: 93793:e52d8e888df1
user: Berker Peksag <berker.peksag at gmail.com>
date: Wed Dec 10 01:47:02 2014 +0200
summary:
Issue #12602: Add missing cross-references to runpy and using/cmdline docs.
Patch by Éric Araujo.
files:
Doc/library/runpy.rst | 13 ++++++++++---
Doc/tutorial/interpreter.rst | 2 ++
Doc/using/cmdline.rst | 12 ++++++++----
3 files changed, 20 insertions(+), 7 deletions(-)
diff --git a/Doc/library/runpy.rst b/Doc/library/runpy.rst
--- a/Doc/library/runpy.rst
+++ b/Doc/library/runpy.rst
@@ -75,6 +75,9 @@
arguments. It is recommended that the :mod:`sys` module be left alone when
invoking this function from threaded code.
+ .. seealso::
+ The :option:`-m` option offering equivalent functionality from the
+ command line.
.. versionchanged:: 3.1
Added ability to execute packages by looking for a ``__main__`` submodule.
@@ -146,6 +149,10 @@
limitations still apply, use of this function in threaded code should be
either serialised with the import lock or delegated to a separate process.
+ .. seealso::
+ :ref:`using-on-interface-options` for equivalent functionality on the
+ command line (``python path/to/script``).
+
.. versionadded:: 3.2
.. versionchanged:: 3.4
@@ -156,13 +163,13 @@
.. seealso::
- :pep:`338` - Executing modules as scripts
+ :pep:`338` -- Executing modules as scripts
PEP written and implemented by Nick Coghlan.
- :pep:`366` - Main module explicit relative imports
+ :pep:`366` -- Main module explicit relative imports
PEP written and implemented by Nick Coghlan.
- :pep:`451` - A ModuleSpec Type for the Import System
+ :pep:`451` -- A ModuleSpec Type for the Import System
PEP written and implemented by Eric Snow
:ref:`using-on-general` - CPython command line details
diff --git a/Doc/tutorial/interpreter.rst b/Doc/tutorial/interpreter.rst
--- a/Doc/tutorial/interpreter.rst
+++ b/Doc/tutorial/interpreter.rst
@@ -63,6 +63,8 @@
and enter interactive mode afterwards. This can be done by passing :option:`-i`
before the script.
+All command line options are described in :ref:`using-on-general`.
+
.. _tut-argpassing:
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst
--- a/Doc/using/cmdline.rst
+++ b/Doc/using/cmdline.rst
@@ -1,7 +1,7 @@
-.. highlightlang:: none
+.. highlightlang:: sh
.. ATTENTION: You probably should update Misc/python.man, too, if you modify
-.. this file.
+ this file.
.. _using-on-general:
@@ -148,6 +148,10 @@
added to the start of :data:`sys.path` and the ``__main__.py`` file in
that location is executed as the :mod:`__main__` module.
+ .. seealso::
+ :func:`runpy.run_path`
+ Equivalent functionality directly available to Python code
+
If no interface option is given, :option:`-i` is implied, ``sys.argv[0]`` is
an empty string (``""``) and the current directory will be added to the
@@ -155,11 +159,11 @@
automatically enabled, if available on your platform (see
:ref:`rlcompleter-config`).
+.. seealso:: :ref:`tut-invoking`
+
.. versionchanged:: 3.4
Automatic enabling of tab-completion and history editing.
-.. seealso:: :ref:`tut-invoking`
-
Generic options
~~~~~~~~~~~~~~~
--
Repository URL: https://hg.python.org/cpython
More information about the Python-checkins
mailing list