mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Clarify example.
This commit is contained in:
parent
9cc47218b6
commit
9d7b75aa5d
@ -325,14 +325,15 @@ directives.) Looking at this example, ::
|
|||||||
|
|
||||||
.. function:: foo(x)
|
.. function:: foo(x)
|
||||||
foo(y, z)
|
foo(y, z)
|
||||||
:bar: no
|
:module: some.module.name
|
||||||
|
|
||||||
Return a line of text input from the user.
|
Return a line of text input from the user.
|
||||||
|
|
||||||
``function`` is the directive name. It is given two arguments here, the
|
``function`` is the directive name. It is given two arguments here, the
|
||||||
remainder of the first line and the second line, as well as one option ``bar``
|
remainder of the first line and the second line, as well as one option
|
||||||
(as you can see, options are given in the lines immediately following the
|
``module`` (as you can see, options are given in the lines immediately following
|
||||||
arguments and indicated by the colons).
|
the arguments and indicated by the colons). Options must be indented to the
|
||||||
|
same level as the directive content.
|
||||||
|
|
||||||
The directive content follows after a blank line and is indented relative to the
|
The directive content follows after a blank line and is indented relative to the
|
||||||
directive start.
|
directive start.
|
||||||
|
Loading…
Reference in New Issue
Block a user