]> git.baikalelectronics.ru Git - kernel.git/commit
doc-rst:c-domain: ref-name of a function declaration
authorMarkus Heiser <markus.heiser@darmarIT.de>
Mon, 15 Aug 2016 14:08:25 +0000 (16:08 +0200)
committerJonathan Corbet <corbet@lwn.net>
Mon, 22 Aug 2016 21:19:22 +0000 (15:19 -0600)
commitb1a7bd64bd368e354762a8597050aa46caac723a
treec18c69bd8fca8a662434864c714b0c884642a85b
parent9958c0ad892ba677bb9786750fdee46744ad54c8
doc-rst:c-domain: ref-name of a function declaration

Add option 'name' to the "c:function:" directive.  With option 'name'
the ref-name of a function can be modified. E.g.::

    .. c:function:: int ioctl( int fd, int request )
       :name: VIDIOC_LOG_STATUS

The func-name (e.g. ioctl) remains in the output but the ref-name
changed from ``ioctl`` to ``VIDIOC_LOG_STATUS``. The index entry for
this function is also changed to ``VIDIOC_LOG_STATUS`` and the function
can now referenced by::

    :c:func:`VIDIOC_LOG_STATUS`

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/kernel-documentation.rst
Documentation/sphinx/cdomain.py