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.)

  • Participants
  • Parent commits a75e989

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

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