[pypy-commit] pypy improve-docs: (ronan, mjacob) Fix reST syntax in whatsnew documents.

[mjacob]

Author: Manuel Jacob <me at manueljacob.de>
Branch: improve-docs
Changeset: r74089:81357bbe547c
Date: 2014-10-22 17:13 +0200
http://bitbucket.org/pypy/pypy/changeset/81357bbe547c/

Log:	(ronan, mjacob) Fix reST syntax in whatsnew documents.

diff --git a/pypy/doc/whatsnew-2.0.0-beta1.rst b/pypy/doc/whatsnew-2.0.0-beta1.rst
--- a/pypy/doc/whatsnew-2.0.0-beta1.rst
+++ b/pypy/doc/whatsnew-2.0.0-beta1.rst
@@ -22,7 +22,7 @@
 
 Check that axis arg is valid in _numpypy
 
-.. branch:less-gettestobjspace
+.. branch: less-gettestobjspace
 
 .. branch: move-apptest-support
 
diff --git a/pypy/doc/whatsnew-2.1.rst b/pypy/doc/whatsnew-2.1.rst
--- a/pypy/doc/whatsnew-2.1.rst
+++ b/pypy/doc/whatsnew-2.1.rst
@@ -6,78 +6,100 @@
 .. startrev: a13c07067613
 
 .. branch: ndarray-ptp
+
 put and array.put
 
 .. branch: numpy-pickle
+
 Pickling of numpy arrays and dtypes (including record dtypes)
 
 .. branch: remove-array-smm
+
 Remove multimethods in the arraymodule
 
 .. branch: callback-stacklet
+
 Fixed bug when switching stacklets from a C callback
 
 .. branch: remove-set-smm
+
 Remove multi-methods on sets
 
 .. branch: numpy-subarrays
+
 Implement subarrays for numpy
 
 .. branch: remove-dict-smm
+
 Remove multi-methods on dict
 
 .. branch: remove-list-smm-2
+
 Remove remaining multi-methods on list
 
 .. branch: arm-stacklet
+
 Stacklet support for ARM, enables _continuation support
 
 .. branch: remove-tuple-smm
+
 Remove multi-methods on tuple
 
 .. branch: remove-iter-smm
+
 Remove multi-methods on iterators
 
 .. branch: emit-call-x86
 .. branch: emit-call-arm
 
 .. branch: on-abort-resops
+
 Added list of resops to the pypyjit on_abort hook.
 
 .. branch: logging-perf
+
 Speeds up the stdlib logging module
 
 .. branch: operrfmt-NT
+
 Adds a couple convenient format specifiers to operationerrfmt
 
 .. branch: win32-fixes3
+
 Skip and fix some non-translated (own) tests for win32 builds
 
 .. branch: ctypes-byref
+
 Add the '_obj' attribute on ctypes pointer() and byref() objects
 
 .. branch: argsort-segfault
+
 Fix a segfault in argsort when sorting by chunks on multidim numpypy arrays (mikefc)
 
 .. branch: dtype-isnative
 .. branch: ndarray-round
 
 .. branch: faster-str-of-bigint
+
 Improve performance of str(long).
 
 .. branch: ndarray-view
+
 Add view to ndarray and zeroD arrays, not on dtype scalars yet
 
 .. branch: numpypy-segfault
+
 fix segfault caused by iterating over empty ndarrays
 
 .. branch: identity-set
+
 Faster sets for objects
 
 .. branch: inline-identityhash
+
 Inline the fast path of id() and hash()
 
 .. branch: package-tk
+
 Adapt package.py script to compile CFFI tk extension. Add a --without-tk switch
 to optionally skip it.
-
diff --git a/pypy/doc/whatsnew-2.2.rst b/pypy/doc/whatsnew-2.2.rst
--- a/pypy/doc/whatsnew-2.2.rst
+++ b/pypy/doc/whatsnew-2.2.rst
@@ -6,31 +6,38 @@
 .. startrev: 4eb52818e7c0
 
 .. branch: sanitise_bytecode_dispatch
+
 Make PyPy's bytecode dispatcher easy to read, and less reliant on RPython
 magic. There is no functional change, though the removal of dead code leads
 to many fewer tests to execute.
 
 .. branch: fastjson
+
 Fast json decoder written in RPython, about 3-4x faster than the pure Python
 decoder which comes with the stdlib
 
 .. branch: improve-str2charp
+
 Improve the performance of I/O writing up to 15% by using memcpy instead of
 copying char-by-char in str2charp and get_nonmovingbuffer
 
 .. branch: flowoperators
+
 Simplify rpython/flowspace/ code by using more metaprogramming.  Create
 SpaceOperator class to gather static information about flow graph operations.
 
 .. branch: package-tk
+
 Adapt package.py script to compile CFFI tk extension. Add a --without-tk switch
 to optionally skip it.
 
 .. branch: distutils-cppldflags
+
 Copy CPython's implementation of customize_compiler, dont call split on
 environment variables, honour CFLAGS, CPPFLAGS, LDSHARED and LDFLAGS on Unices.
 
 .. branch: precise-instantiate
+
 When an RPython class is instantiated via an indirect call (that is, which
 class is being instantiated isn't known precisely) allow the optimizer to have
 more precise information about which functions can be called. Needed for Topaz.
@@ -38,48 +45,59 @@
 .. branch: ssl_moving_write_buffer
 
 .. branch: pythoninspect-fix
+
 Make PyPy respect PYTHONINSPECT variable set via os.putenv in the same process
 to start interactive prompt when the script execution finishes. This adds
 new __pypy__.os.real_getenv call that bypasses Python cache and looksup env
 in the underlying OS. Translatorshell now works on PyPy.
 
 .. branch: add-statvfs
+
 Added os.statvfs and os.fstatvfs
 
 .. branch: statvfs_tests
+
 Added some addition tests for statvfs.
 
 .. branch: ndarray-subtype
+
 Allow subclassing ndarray, i.e. matrix
 
 .. branch: ndarray-sort
+
 Implement ndarray in-place sorting (for numeric types, no non-native byte order)
 
 .. branch: pypy-pyarray
+
 Implement much of numpy's c api in cpyext, allows (slow) access to ndarray
 from c
 
 .. branch: kill-ootype
 
 .. branch: fast-slowpath
+
 Added an abstraction for functions with a fast and slow path in the JIT. This
 speeds up list.append() and list.pop().
 
 .. branch: curses_fixes
 
 .. branch: foldable-getarrayitem-indexerror
+
 Constant-fold reading out of constant tuples in PyPy.
 
 .. branch: mro-reorder-numpypy-str
+
 No longer delegate numpy string_ methods to space.StringObject, in numpy
 this works by kind of by accident. Support for merging the refactor-str-types
 branch
 
 .. branch: kill-typesystem
+
 Remove the "type system" abstraction, now that there is only ever one kind of
 type system used.
 
 .. branch: kill-gen-store-back-in
+
 Kills gen_store_back_in_virtualizable - should improve non-inlined calls by
 a bit
 
@@ -95,15 +113,19 @@
 .. branch: fileops2
 
 .. branch: nobold-backtrace
+
 Work on improving UnionError messages and stack trace displays.
 
 .. branch: improve-errors-again
+
 More improvements and refactorings of error messages.
 
 .. branch: improve-errors-again2
+
 Unbreak tests in rlib.
 
 .. branch: less-stringly-ops
+
 Use subclasses of SpaceOperation instead of SpaceOperator objects.
 Random cleanups in flowspace.
 
@@ -111,30 +133,38 @@
 make open() and friends rpython
 
 .. branch: incremental-gc
+
 Added the new incminimark GC which performs GC in incremental steps
 
 .. branch: fast_cffi_list_init
+
 fastpath for cffi.new("long[]")
 
 .. branch: remove-eval-frame
+
 remove a pointless abstraction
 
 .. branch: jit-settrace
+
 Allow the jit to continue running when sys.settrace() is active, necessary to
 make coverage.py fast
 
 .. branch: remove-numpypy
+
 Remove lib_pypy/numpypy in favor of external numpy fork
 
 .. branch: jit-counter
+
 Tweak the jit counters: decay them at minor collection (actually
 only every 32 minor collection is enough). Should avoid the "memory
 leaks" observed in long-running processes, actually created by the
 jit compiling more and more rarely executed paths.
 
 .. branch: fix-trace-jit
+
 Fixed the usage of sys.settrace() with the JIT. Also made it so using
 sys.settrace() doesn't cause the GIL to be released on every single iteration.
 
 .. branch: rordereddict
+
 Implement OrderedDict in RPython
diff --git a/pypy/doc/whatsnew-2.3.0.rst b/pypy/doc/whatsnew-2.3.0.rst
--- a/pypy/doc/whatsnew-2.3.0.rst
+++ b/pypy/doc/whatsnew-2.3.0.rst
@@ -1,6 +1,6 @@
-=======================
-What's new since PyPy 2.2.1?
-=======================
+========================
+What's new in PyPy 2.2.1
+========================
 
 .. this is a revision shortly after release-2.2.x
 .. startrev: 4cd1bc8b3111
@@ -8,114 +8,144 @@
 .. branch: release-2.2.x
 
 .. branch: numpy-newbyteorder
+
 Clean up numpy types, add newbyteorder functionality
 
 .. branch: windows-packaging
+
 Package tk/tcl runtime with win32
 
 .. branch: armhf-singlefloat
+
 JIT support for singlefloats on ARM using the hardfloat ABI
 
 .. branch: voidtype_strformat
+
 Better support for record numpy arrays
 
 .. branch: osx-eci-frameworks-makefile
+
 OSX: Ensure frameworks end up in Makefile when specified in External compilation info
 
 .. branch: less-stringly-ops
+
 Use subclasses of SpaceOperation instead of SpaceOperator objects.
 Random cleanups in flowspace and annotator.
 
 .. branch: ndarray-buffer
+
 adds support for the buffer= argument to the ndarray ctor
 
 .. branch: better_ftime_detect2
+
 On OpenBSD do not pull in libcompat.a as it is about to be removed.
 And more generally, if you have gettimeofday(2) you will not need ftime(3).
 
 .. branch: timeb_h
+
 Remove dependency upon <sys/timeb.h> on OpenBSD. This will be disappearing
 along with libcompat.a.
 
 .. branch: OlivierBlanvillain/fix-3-broken-links-on-pypy-published-pap-1386250839215
+
 Fix 3 broken links on PyPy published papers in docs.
 
 .. branch: jit-ordereddict
 
 .. branch: refactor-str-types
+
 Remove multimethods on str/unicode/bytearray and make the implementations share code.
 
 .. branch: remove-del-from-generatoriterator
+
 Speed up generators that don't yield inside try or wait blocks by skipping
 unnecessary cleanup.
 
 .. branch: annotator
+
 Remove FlowObjSpace.
 Improve cohesion between rpython.flowspace and rpython.annotator.
 
 .. branch: detect-immutable-fields
+
 mapdicts keep track of whether or not an attribute is every assigned to
 multiple times. If it's only assigned once then an elidable lookup is used when
 possible.
 
 .. branch: precompiled-headers
+
 Create a Makefile using precompiled headers for MSVC platforms.
 The downside is a messy nmake-compatible Makefile. Since gcc shows minimal
 speedup, it was not implemented.
 
 .. branch: camelot
+
 With a properly configured 256-color terminal (TERM=...-256color), the
 Mandelbrot set shown during translation now uses a range of 50 colours.
 Essential!
 
 .. branch: NonConstant
+
 Simplify implementation of NonConstant.
 
 .. branch: array-propagate-len
+
 Kill some guards and operations in JIT traces by adding integer bounds
 propagation for getfield_(raw|gc) and getarrayitem_(raw|gc).
 
 .. branch: optimize-int-and
+
 Optimize away INT_AND with constant mask of 1s that fully cover the bitrange
 of other operand.
 
 .. branch: bounds-int-add-or
+
 Propagate appropriate bounds through INT_(OR|XOR|AND) operations if the
 operands are positive to kill some guards
 
 .. branch: remove-intlong-smm
+
 kills int/long/smalllong/bool multimethods
 
 .. branch: numpy-refactor
+
 Cleanup micronumpy module
 
 .. branch: int_w-refactor
+
 In a lot of places CPython allows objects with __int__ and __float__ instead of actual ints and floats, while until now pypy disallowed them. We fix it by making space.{int_w,float_w,etc.} accepting those objects by default, and disallowing conversions only when explicitly needed.
 
 .. branch: test-58c3d8552833
+
 Fix for getarrayitem_gc_pure optimization
 
 .. branch: simple-range-strategy
+
 Implements SimpleRangeListStrategy for case range(n) where n is a positive number.
 Makes some traces nicer by getting rid of multiplication for calculating loop counter
 and propagates that n > 0 further to get rid of guards.
 
 .. branch: popen-pclose
+
 Provide an exit status for popen'ed RFiles via pclose
 
 .. branch: stdlib-2.7.6
+
 Update stdlib to v2.7.6
 
 .. branch: virtual-raw-store-load
+
 Support for virtualizing raw_store/raw_load operations
 
 .. branch: refactor-buffer-api
+
 Separate the interp-level buffer API from the buffer type exposed to
 app-level.  The `Buffer` class is now used by `W_MemoryView` and
 `W_Buffer`, which is not present in Python 3.  Previously `W_Buffer` was
 an alias to `Buffer`, which was wrappable itself.
 
 .. branch: improve-consecutive-dict-lookups
+
 Improve the situation when dict lookups of the same key are performed in a chain
 
 .. branch: add_PyErr_SetFromErrnoWithFilenameObject_try_2
@@ -123,34 +153,44 @@
 .. branch: test_SetFromErrnoWithFilename__tweaks
 
 .. branch: refactor_PyErr_SetFromErrnoWithFilename
+
 Add support for PyErr_SetFromErrnoWithFilenameObject to cpyext
 
 .. branch: win32-fixes4
+
 fix more tests for win32
 
 .. branch: latest-improve-doc
+
 Fix broken links in documentation
 
 .. branch: ast-issue1673
+
 fix ast classes __dict__ are always empty problem and fix the ast deepcopy issue when 
 there is missing field
 
 .. branch: issue1514
+
 Fix issues with reimporting builtin modules
 
 .. branch: numpypy-nditer
+
 Implement the core of nditer, without many of the fancy flags (external_loop, buffered)
 
 .. branch: numpy-speed
+
 Separate iterator from its state so jit can optimize better
 
 .. branch: numpy-searchsorted
+
 Implement searchsorted without sorter kwarg
 
 .. branch: openbsd-lib-prefix
+
 add 'lib' prefix to link libraries on OpenBSD
 
 .. branch: small-unroll-improvements
+
 Improve optimization of small allocation-heavy loops in the JIT
 
 .. branch: reflex-support
@@ -160,13 +200,17 @@
 .. branch: lexer_token_position_class
 
 .. branch: refactor-buffer-api
+
 Properly implement old/new buffer API for objects and start work on replacing bufferstr usage
 
 .. branch: issue1430
+
 Add a lock for unsafe calls to gethostbyname and gethostbyaddr
 
 .. branch: fix-tpname
+
 Changes hacks surrounding W_TypeObject.name to match CPython's tp_name
 
 .. branch: tkinter_osx_packaging
+
 OS/X specific header path
diff --git a/pypy/doc/whatsnew-2.3.1.rst b/pypy/doc/whatsnew-2.3.1.rst
--- a/pypy/doc/whatsnew-2.3.1.rst
+++ b/pypy/doc/whatsnew-2.3.1.rst
@@ -1,6 +1,6 @@
-=======================
-What's new since PyPy 2.3?
-=======================
+======================
+What's new in PyPy 2.3
+======================
 
 .. this is a revision shortly after release-2.3
 .. startrev: 394146e9bb67
@@ -17,7 +17,8 @@
 
 .. branch: unify-call-ops
 
-.. branch packaging
+.. branch: packaging
+
 Use argparse for packaging.py, and add third-party components to LICENSE file.
 Also mention that gdbm is GPL.
 Do not crash the packaging process on failure in CFFI or license-building,
diff --git a/pypy/doc/whatsnew-2.4.0.rst b/pypy/doc/whatsnew-2.4.0.rst
--- a/pypy/doc/whatsnew-2.4.0.rst
+++ b/pypy/doc/whatsnew-2.4.0.rst
@@ -6,12 +6,14 @@
 .. startrev: ca9b7cf02cf4
 
 .. branch: fix-bytearray-complexity
+
 Bytearray operations no longer copy the bytearray unnecessarily
 
 Added support for ``__getitem__``, ``__setitem__``, ``__getslice__``,
 ``__setslice__``,  and ``__len__`` to RPython
 
 .. branch: stringbuilder2-perf
+
 Give the StringBuilder a more flexible internal structure, with a
 chained list of strings instead of just one string. This make it
 more efficient when building large strings, e.g. with cStringIO().
@@ -24,6 +26,7 @@
 programs.
 
 .. branch: ec-threadlocal
+
 Change the executioncontext's lookup to be done by reading a thread-
 local variable (which is implemented in C using '__thread' if
 possible, and pthread_getspecific() otherwise). On Linux x86 and
@@ -32,6 +35,7 @@
 actually to give a good boost in performance.
 
 .. branch: fast-gil
+
 A faster way to handle the GIL, particularly in JIT code. The GIL is
 now a composite of two concepts: a global number (it's just set from
 1 to 0 and back around CALL_RELEASE_GIL), and a real mutex. If there
@@ -41,26 +45,32 @@
 started yet), or a *lot* faster (if threads were started already).
 
 .. branch: jit-get-errno
+
 Optimize the errno handling in the JIT, notably around external
 function calls. Linux-only.
 
 .. branch: disable_pythonapi
+
 Remove non-functioning ctypes.pyhonapi and ctypes.PyDLL, document this
 incompatibility with cpython. Recast sys.dllhandle to an int.
 
 .. branch: scalar-operations
+
 Fix performance regression on ufunc(<scalar>, <scalar>) in numpy.
 
 .. branch: pytest-25
+
 Update our copies of py.test and pylib to versions 2.5.2 and 1.4.20, 
 respectively.
 
 .. branch: split-ast-classes
+
 Classes in the ast module are now distinct from structures used by the compiler.
 
 .. branch: stdlib-2.7.8
+
 Upgrades from 2.7.6 to 2.7.8
 
 .. branch: cpybug-seq-radd-rmul
+
 Fix issue #1861 - cpython compatability madness
-
diff --git a/pypy/doc/whatsnew-head.rst b/pypy/doc/whatsnew-head.rst
--- a/pypy/doc/whatsnew-head.rst
+++ b/pypy/doc/whatsnew-head.rst
@@ -1,4 +1,3 @@
-
 =======================
 What's new in PyPy 2.5+
 =======================
@@ -7,6 +6,7 @@
 .. startrev: 7026746cbb1b
 
 .. branch: win32-fixes5
+
 Fix c code generation for msvc so empty "{ }" are avoided in unions,
 Avoid re-opening files created with NamedTemporaryFile,
 Allocate by 4-byte chunks in rffi_platform,
@@ -14,11 +14,14 @@
 and other small adjustments in own tests
 
 .. branch: rtyper-stuff
+
 Small internal refactorings in the rtyper.
 
 .. branch: var-in-Some
+
 Store annotations on the Variable objects, rather than in a big dict.
 Introduce a new framework for double-dispatched annotation implementations.
 
 .. branch: ClassRepr
+
 Refactor ClassRepr and make normalizecalls independent of the rtyper.