https://github.com/python/cpython/commit/479e366ce3b61a33a13e1b94b70cd5395710569b commit: 479e366ce3b61a33a13e1b94b70cd5395710569b branch: 3.12 author: Miss Islington (bot) <[email protected]> committer: willingc <[email protected]> date: 2024-11-01T12:36:51-07:00 summary:
[3.12] Docs: make a tutorial example more precise (GH-125066) (GH-125079) Docs: make a tutorial example more precise (GH-125066) Based on discussion here: (cherry picked from commit 6e3c70c61bf961e55e9912a31ca11f61c8e2cd0c) https: //discuss.python.org/t/omission-in-the-documentation/66816 Co-authored-by: Ned Batchelder <[email protected]> files: M Doc/tutorial/introduction.rst diff --git a/Doc/tutorial/introduction.rst b/Doc/tutorial/introduction.rst index 054bac59c955d5..65e3b1938bca9c 100644 --- a/Doc/tutorial/introduction.rst +++ b/Doc/tutorial/introduction.rst @@ -197,21 +197,19 @@ and workarounds. String literals can span multiple lines. One way is using triple-quotes: ``"""..."""`` or ``'''...'''``. End of lines are automatically included in the string, but it's possible to prevent this by adding a ``\`` at -the end of the line. The following example:: - - print("""\ +the end of the line. In the following example, the initial newline is not +included:: + + >>> print("""\ + ... Usage: thingy [OPTIONS] + ... -h Display this usage message + ... -H hostname Hostname to connect to + ... """) Usage: thingy [OPTIONS] -h Display this usage message -H hostname Hostname to connect to - """) - -produces the following output (note that the initial newline is not included): -.. code-block:: text - - Usage: thingy [OPTIONS] - -h Display this usage message - -H hostname Hostname to connect to + >>> Strings can be concatenated (glued together) with the ``+`` operator, and repeated with ``*``:: _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3/lists/python-checkins.python.org/ Member address: [email protected]
