[docs] [issue14112] tutorial intro talks of "shallow copy" concept without explanation
Tshepang Lekhonkhobe
report at bugs.python.org
Sat Feb 25 10:51:25 CET 2012
Tshepang Lekhonkhobe <tshepang at gmail.com> added the comment:
On Sat, Feb 25, 2012 at 09:35, Éric Araujo <report at bugs.python.org> wrote:
> What about this:
>
> All slice operations return a new list containing the requested elements. This
> -means that the following slice returns a shallow copy of the list *a*::
> +means that the following slice returns a shallow copy (see the documentation of
> +the :mod:`copy` module for a definition) of the list *a*::
That's kool, though I like Ezio's idea of putting it on a glossary
(and then linking to it) even more.
> (BTW, you can use syntax like Doc/tutorial/introduction.rst:487 to have links generated; see http://docs.python.org/devguide/triaging#generating-special-links-in-a-comment —also linked from the “Comment” label in the form, but it isn’t obvious that it’s a link).
Thanks for the pointer. Note however that I chose my approach because
it shows the info at a specific revision, in case the content changes
later on.
----------
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue14112>
_______________________________________
More information about the docs
mailing list