This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author amaajemyfren
Recipients Chas Belov, amaajemyfren, docs@python
Date 2020-05-24.12:17:41
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <CAKyeSh0S7coKsou=c=D6o4ikHYXc4A9p6c2MhKwHbvB-z84HoQ@mail.gmail.com>
In-reply-to <1590272831.41.0.177431778032.issue40748@roundup.psfhosted.org>
Content
Hi @Chas Belov,

On Sun, May 24, 2020 at 1:27 AM Chas Belov <report@bugs.python.org> wrote:

> The tutorial on More on Defining Functions at https://docs.python.org/3.7/tutorial/controlflow.html#more-on-defining-functions is missing most of the >>> and ... screen prompts that show elsewhere in the tutorial. This is potentially confusing to readers.
>
> I am going to attempt a PR by May 26, 2020.

Are those sections really to be entered in the REPL or could they be
seen as independent code blocks in a file e.g.?
From the dev guide https://devguide.python.org/documenting/#code-examples

> The ellipsis for the sys.ps2 secondary interpreter prompt should only be used sparingly,
> where it is necessary to clearly differentiate between input lines and output lines.
> Besides contributing visual clutter, it makes it difficult for readers to cut-and-paste
> examples so they can experiment with variations.

None of those sections has output ... so maybe not put the ellipsis?
History
Date User Action Args
2020-05-24 12:17:41amaajemyfrensetrecipients: + amaajemyfren, Chas Belov
2020-05-24 12:17:41amaajemyfrenlinkissue40748 messages
2020-05-24 12:17:41amaajemyfrencreate