.. highlight:: c
+.. _howto-clinic:
+
**********************
Argument Clinic How-To
**********************
and *__weakref__* for each instance.
+.. _datamodel-note-slots:
+
Notes on using *__slots__*
""""""""""""""""""""""""""
.. deprecated:: 3.6
``pyvenv`` was the recommended tool for creating virtual environments for
- Python 3.3 and 3.4, and is `deprecated in Python 3.6
- <https://docs.python.org/dev/whatsnew/3.6.html#id8>`_.
+ Python 3.3 and 3.4, and is
+ :ref:`deprecated in Python 3.6 <whatsnew36-venv>`.
.. versionchanged:: 3.5
The use of ``venv`` is now recommended for creating virtual environments.
of an explanation to start you programming, but many details have been
simplified or ignored. Where should you go to get a more complete picture?
-https://docs.python.org/dev/howto/descriptor.html is a lengthy tutorial introduction to
+The :ref:`descriptorhowto` is a lengthy tutorial introduction to
the descriptor features, written by Guido van Rossum. If my description has
whetted your appetite, go read this tutorial next, because it goes into much
more detail about the new features while still remaining quite easy to read.
The :mod:`tkinter.tix` module is now deprecated. :mod:`tkinter` users
should use :mod:`tkinter.ttk` instead.
+.. _whatsnew36-venv:
+
venv
~~~~
There is a new function parameter syntax ``/`` to indicate that some
function parameters must be specified positionally and cannot be used as
keyword arguments. This is the same notation shown by ``help()`` for C
-functions annotated with Larry Hastings' `Argument Clinic
-<https://docs.python.org/3/howto/clinic.html>`_ tool.
+functions annotated with Larry Hastings'
+:ref:`Argument Clinic <howto-clinic>` tool.
In the following example, parameters *a* and *b* are positional-only,
while *c* or *d* can be positional or keyword, and *e* or *f* are
.. section: Documentation
Add an entry for ``__module__`` in the "function" & "method" sections of the
-`inspect docs types and members table
-<https://docs.python.org/3/library/inspect.html#types-and-members>`_
+:mod:`inspect` docs' :ref:`inspect-types` table.
..