diff options
| author | Georg Brandl <georg@python.org> | 2009-01-22 18:29:28 +0000 |
|---|---|---|
| committer | Georg Brandl <georg@python.org> | 2009-01-22 18:29:28 +0000 |
| commit | 40e841550930e3729597b649814940d4cbeabf18 (patch) | |
| tree | 16e1cabcfc094f297d1ada054f8c7d7ce0bd27de | |
| parent | 1bc1c8ac766e62116bd9d677712c59d681e44c0e (diff) | |
| download | cpython-git-40e841550930e3729597b649814940d4cbeabf18.tar.gz | |
Clarify wording.
| -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 80b43b9850..b4b03d27a5 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 |