diff options
author | Georg Brandl <georg@python.org> | 2010-10-06 09:29:36 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2010-10-06 09:29:36 (GMT) |
commit | b79b15239658a09f4efa450fe938e769f0d99524 (patch) | |
tree | 03a81e0562eb6abaa2433c1a3b40ff5704239539 /Misc | |
parent | 90e7a5b8c84e6a240c7ce181d8b9207d7cc058ea (diff) | |
download | cpython-b79b15239658a09f4efa450fe938e769f0d99524.zip cpython-b79b15239658a09f4efa450fe938e769f0d99524.tar.gz cpython-b79b15239658a09f4efa450fe938e769f0d99524.tar.bz2 |
Remove NEWS.help (manual backport of r84533).
Diffstat (limited to 'Misc')
-rw-r--r-- | Misc/NEWS | 2 | ||||
-rw-r--r-- | Misc/NEWS.help | 73 |
2 files changed, 0 insertions, 75 deletions
@@ -2,8 +2,6 @@ Python News +++++++++++ -(editors: check NEWS.help for information about editing NEWS using ReST.) - What's New in Python 3.1.3? =========================== diff --git a/Misc/NEWS.help b/Misc/NEWS.help deleted file mode 100644 index 856785f..0000000 --- a/Misc/NEWS.help +++ /dev/null @@ -1,73 +0,0 @@ - -*- text -*- - -If you edited Misc/NEWS before it was converted to ReST format skimming this -file should help make the transition a bit easier. For full details about -Docutils and ReST, go to the Docutils website: - - http://docutils.sourceforge.net/ - -To process Misc/NEWS using Docutils, you'll need the latest docutils -snapshot: - - http://docutils.sf.net/docutils-snapshot.tgz - -Docutils works with Python 2.2 or newer. - -To process NEWS into NEWS.html, first install Docutils, and then run -this command: - - python .../docutils/tools/rst2html.py NEWS NEWS.html - -Here ".../docutils" is the directory into which the above snapshot was -extracted. (I hope this recipe will change for the better.) - -David Goodger made a change to the allowable structure of internal -references which greatly simplified initial conversion of the file. - -The changes required fell into the following categories: - -* The top-level "What's New" section headers changed to: - - What's New in Python 2.3 alpha 1? - ================================= - - *Release date: DD-MMM-2002* - - Note that the release date line is emphasized, with a "*" at each - end. - -* Subsections are underlined with a single row of hyphens: - - Type/class unification and new-style classes - -------------------------------------------- - -* Places where "balanced" single quotes were used were changed to use - apostrophes as both the opening and closing quote (`string' -> 'string'). - -* In a few places asterisks needed to be escaped which would otherwise have - been interpreted as beginning blocks of italic or bold text, e.g.: - - - The type of tp_free has been changed from "``void (*)(PyObject *)``" - to "``void (*)(void *)``". - - Note that only the asterisks preceded by whitespace needed to be escaped. - -* One instance of a word ending with an underscore needed to be quoted - ("PyCmp_" became "``PyCmp_``"). - -* One table was converted to ReST form (search Misc/NEWS for "New codecs" - for this example). - -* A few places where chunks of code or indented text were displayed needed - to be properly introduced (preceding paragraph terminated by "::" and the - chunk of code or text indented w.r.t. the paragraph). For example: - - - Note that PyLong_AsDouble can fail! This has always been true, - but no callers checked for it. It's more likely to fail now, - because overflow errors are properly detected now. The proper way - to check:: - - double x = PyLong_AsDouble(some_long_object); - if (x == -1.0 && PyErr_Occurred()) { - /* The conversion failed. */ - } |