diff options
author | Georg Brandl <georg@python.org> | 2009-01-22 18:29:28 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2009-01-22 18:29:28 (GMT) |
commit | 40e841550930e3729597b649814940d4cbeabf18 (patch) | |
tree | 16e1cabcfc094f297d1ada054f8c7d7ce0bd27de /Doc | |
parent | 1bc1c8ac766e62116bd9d677712c59d681e44c0e (diff) | |
download | cpython-40e841550930e3729597b649814940d4cbeabf18.zip cpython-40e841550930e3729597b649814940d4cbeabf18.tar.gz cpython-40e841550930e3729597b649814940d4cbeabf18.tar.bz2 |
Clarify wording.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/documenting/markup.rst | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst index 80b43b9..b4b03d2 100644 --- a/Doc/documenting/markup.rst +++ b/Doc/documenting/markup.rst @@ -285,7 +285,8 @@ Inline markup As said before, Sphinx uses interpreted text roles to insert semantic markup in documents. -Variable names are an exception, they should be marked simply with ``*var*``. +Names of local variables, such as function/method arguments, are an exception, +they should be marked simply with ``*var*``. For all other roles, you have to write ``:rolename:`content```. @@ -310,7 +311,7 @@ a matching identifier is found: .. describe:: data - The name of a module-level variable. + The name of a module-level variable or constant. .. describe:: const |