Commits

Georg Brandl committed b0ab832

Fix reST in NEWS, and remove NEWS.help (all committers should now know reST anyway, and for those who do not, there is Documenting Python.)

Comments (0)

Files changed (2)

 Python News
 +++++++++++
 
-(editors: check NEWS.help for information about editing NEWS using ReST.)
-
 What's New in Python 3.2 Alpha 2?
 =================================
 
 - Issue #7072: isspace(0xa0) is true on Mac OS X.
 
 - Issue #8084: PEP 370 now conforms to system conventions for framework builds
-  on MacOS X. That is, "python setup.py install --user" will install
-    into "~/Library/Python/2.7" instead of "~/.local".
+  on MacOS X. That is, "python setup.py install --user" will install into
+  "~/Library/Python/2.7" instead of "~/.local".
 
 C-API
 -----
 - Issue #4179: In pdb, allow "list ." as a command to return to the currently
   debugged line.
 
-- Issue #4108: In urllib.robotparser, if there are multiple 'User-agent: *'
+- Issue #4108: In urllib.robotparser, if there are multiple ``User-agent: *``
   entries, consider the first one.
 
 - Issue #6630: Allow customizing regex flags when subclassing the
 - Issue #7347: winreg: Add CreateKeyEx and DeleteKeyEx, as well as fix a bug in
   the return value of QueryReflectionKey.
 
-- Issue #7567: PyCurses_setupterm: Don't call `setupterm' twice.
+- Issue #7567: PyCurses_setupterm: Don't call ``setupterm`` twice.
 
 Build
 -----
 - Issue #8510: Update to autoconf2.65.
 
 Documentation
-------------
+-------------
 
 - Issue #9524: Document that two CTRL* signals are meant for use only
   with os.kill.
 - Issue #2170: refactored xml.dom.minidom.normalize, increasing both
   its clarity and its speed.
 
-- Issue #1113244: Py_XINCREF, Py_DECREF, Py_XDECREF: Add `do { ... } while (0)'
+- Issue #1113244: Py_XINCREF, Py_DECREF, Py_XDECREF: Add ``do { ... } while (0)``
   to avoid compiler warnings.
 
 - Issue #3739: The unicode-internal encoder now reports the number of characters
   optional module state data.
 
 - Issue #4910: Rename nb_long slot to nb_reserved, and change its
-  type to (void *).
+  type to ``(void *)``.
 
 - Issue #4935: The overflow checking code in the expandtabs() method common
   to str, bytes and bytearray could be optimized away by the compiler, letting
 - Issue #4747: When the terminal does not use utf-8, executing a script with
   non-ascii characters in its name could fail with a "SyntaxError: None" error.
 
-- Issue #4797: IOError.filename was not set when _fileio.FileIO failed to open
-  file with `bytes' filename on Windows.
+- Issue #4797: IOError.filename was not set when ``_fileio.FileIO`` failed
+  to open file with a bytes filename on Windows.
 
 - Issue #3680: Reference cycles created through a dict, set or deque iterator
   did not get collected.
 - Issue #5386: mmap.write_byte didn't check map size, so it could cause buffer
   overrun.
 
-- Issue #1533164: Installed but not listed *.pyo was breaking Distutils
+- Issue #1533164: Installed but not listed ``*.pyo`` was breaking Distutils
   bdist_rpm command.
 
 - Issue #5378: added --quiet option to Distutils bdist_rpm command.
 - Issue #4959: inspect.formatargspec now works for keyword only arguments
   without defaults.
 
-- Issue #3321: _multiprocessing.Connection() doesn't check handle; added checks
-  for *nix machines for negative handles and large int handles. Without this check
+- Issue #3321: ``_multiprocessing.Connection()`` doesn't check handle; added checks
+  for Unix machines for negative handles and large int handles. Without this check
   it is possible to segfault the interpreter.
 
 - Issue #4449: AssertionError in mp_benchmarks.py, caused by an underlying issue

Misc/NEWS.help

-							-*- 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. */
-              }