diff options
author | goodger <goodger@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2002-07-18 01:35:13 +0000 |
---|---|---|
committer | goodger <goodger@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2002-07-18 01:35:13 +0000 |
commit | 46db8cb85f96053f20e7f15f980f84b1ed52a245 (patch) | |
tree | ac8b68acce36fb04761b306d478f951fe3176888 /docs/peps/pep-0287.txt | |
parent | d2293256dba0cdc32d801cbc60d8796fe4be165d (diff) | |
download | docutils-46db8cb85f96053f20e7f15f980f84b1ed52a245.tar.gz |
minor edits
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk/docutils@306 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docs/peps/pep-0287.txt')
-rw-r--r-- | docs/peps/pep-0287.txt | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/peps/pep-0287.txt b/docs/peps/pep-0287.txt index 20e937105..74112d2c5 100644 --- a/docs/peps/pep-0287.txt +++ b/docs/peps/pep-0287.txt @@ -612,8 +612,8 @@ Questions & Answers The PEP markup proposal may be removed if it is deemed that there is no need for PEP markup, or it could be made into a separate PEP. - If accepted, PEP 1, PEP Purpose and Guidelines [PEP-1]_, and PEP 9, - Sample PEP Template [PEP-9]_ will be updated. + If accepted, PEP 1, PEP Purpose and Guidelines [#PEP-1]_, and PEP + 9, Sample PEP Template [#PEP-9]_ will be updated. It seems natural to adopt a single consistent markup standard for all uses of structured plaintext in Python, and to propose it all @@ -706,7 +706,7 @@ Questions & Answers What existing methodologies? For Python docstrings, there is **no** official standard markup format, let alone a documentation - methodology, akin to JavaDoc. The question of methodology is at a + methodology akin to JavaDoc. The question of methodology is at a much higher level than syntax (which this PEP addresses). It is potentially much more controversial and difficult to resolve, and is intentionally left out of this discussion. @@ -761,20 +761,20 @@ References & Footnotes .. _A Record of reStructuredText Syntax Alternatives: http://docutils.sourceforge.net/spec/rst/alternatives.html -.. [PEP-1] PEP 1, PEP Guidelines, Warsaw, Hylton +.. _Docutils: http://docutils.sourceforge.net/ + +.. [#PEP-1] PEP 1, PEP Guidelines, Warsaw, Hylton (http://www.python.org/peps/pep-0001.html) -.. [PEP-9] PEP 9, Sample PEP Template, Warsaw +.. [#PEP-9] PEP 9, Sample PEP Template, Warsaw (http://www.python.org/peps/pep-0009.html) -.. _Docutils: http://docutils.sourceforge.net/ - .. [#Zen] From `The Zen of Python (by Tim Peters)`__ (or just "``import this``" in Python) __ http://www.python.org/doc/Humor.html#zen -.. [PEP-216] PEP 216, Docstring Format, Zadka +.. [#PEP-216] PEP 216, Docstring Format, Zadka (http://www.python.org/peps/pep-0216.html) @@ -787,7 +787,7 @@ This document has been placed in the public domain. Acknowledgements ================ -Some text is borrowed from PEP 216, Docstring Format [PEP-216]_, by +Some text is borrowed from PEP 216, Docstring Format [#PEP-216]_, by Moshe Zadka. Special thanks to all members past & present of the Python Doc-SIG_. |