Author: Matti Picus <[email protected]>
Branch: 
Changeset: r91531:66ce5daf5ff9
Date: 2017-06-05 22:52 +0300
http://bitbucket.org/pypy/pypy/changeset/66ce5daf5ff9/

Log:    clean up many sphinx warnings, update copyright and version

diff --git a/pypy/doc/conf.py b/pypy/doc/conf.py
--- a/pypy/doc/conf.py
+++ b/pypy/doc/conf.py
@@ -59,16 +59,16 @@
 
 # General information about the project.
 project = u'PyPy'
-copyright = u'2016, The PyPy Project'
+copyright = u'2017, The PyPy Project'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '5.4'
+version = '5.8'
 # The full version, including alpha/beta/rc tags.
-release = '5.4.0'
+release = '5.8.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/pypy/doc/discussion/finalizer-order.rst 
b/pypy/doc/discussion/finalizer-order.rst
--- a/pypy/doc/discussion/finalizer-order.rst
+++ b/pypy/doc/discussion/finalizer-order.rst
@@ -60,7 +60,7 @@
 The interface for full finalizers is made with PyPy in mind, but should
 be generally useful.
 
-The idea is that you subclass the ``rgc.FinalizerQueue`` class::
+The idea is that you subclass the ``rgc.FinalizerQueue`` class:
 
 * You must give a class-level attribute ``base_class``, which is the
   base class of all instances with a finalizer.  (If you need
diff --git a/pypy/doc/discussion/rawrefcount.rst 
b/pypy/doc/discussion/rawrefcount.rst
--- a/pypy/doc/discussion/rawrefcount.rst
+++ b/pypy/doc/discussion/rawrefcount.rst
@@ -68,10 +68,12 @@
 and O = list of links created with rawrefcount.create_link_pyobj().
 The PyPy objects in the list O are all W_CPyExtPlaceHolderObject: all
 the data is in the PyObjects, and all outsite references (if any) are
-in C, as "PyObject *" fields.
+in C, as ``PyObject *`` fields.
 
 So, during the collection we do this about P links:
 
+.. code-block:: python
+
     for (p, ob) in P:
         if ob->ob_refcnt != REFCNT_FROM_PYPY
                and ob->ob_refcnt != REFCNT_FROM_PYPY_LIGHT:
@@ -80,6 +82,8 @@
 At the end of the collection, the P and O links are both handled like
 this:
 
+.. code-block:: python
+
     for (p, ob) in P + O:
         if p is not surviving:    # even if 'ob' might be surviving
             unlink p and ob
diff --git a/pypy/doc/index-of-whatsnew.rst b/pypy/doc/index-of-whatsnew.rst
--- a/pypy/doc/index-of-whatsnew.rst
+++ b/pypy/doc/index-of-whatsnew.rst
@@ -30,12 +30,22 @@
    whatsnew-2.0.0-beta1.rst
    whatsnew-1.9.rst
 
+CPython 3.5 compatible versions
+-------------------------------
+
+.. toctree::
+
+   whatsnew-pypy3-head.rst
+   whatsnew-pypy3-5.8.0.rst
+   whatsnew-pypy3-5.7.0.rst
+
 CPython 3.3 compatible versions
 -------------------------------
 
 .. toctree::
 
    whatsnew-pypy3-5.5.0.rst
+   whatsnew-pypy3-5.1.1-alpha1.rst
 
 CPython 3.2 compatible versions
 -------------------------------
diff --git a/pypy/doc/install.rst b/pypy/doc/install.rst
--- a/pypy/doc/install.rst
+++ b/pypy/doc/install.rst
@@ -12,6 +12,7 @@
 and using pip. 
 
 .. _prebuilt-pypy:
+
 Download a pre-built PyPy
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/pypy/doc/objspace.rst b/pypy/doc/objspace.rst
--- a/pypy/doc/objspace.rst
+++ b/pypy/doc/objspace.rst
@@ -250,12 +250,12 @@
 .. py:function:: newunicode(ustr)
 
    Creates a Unicode string from an rpython unicode string.
-   This method may disappear soon and be replaced by :py:function:`newutf8()`.
+   This method may disappear soon and be replaced by :py:function::`newutf8`.
 
 .. py:function:: newutf8(bytestr)
 
    Creates a Unicode string from an rpython byte string, decoded as
-   "utf-8-nosg".  On PyPy3 it is the same as :py:function:`newtext()`.
+   "utf-8-nosg".  On PyPy3 it is the same as :py:function::`newtext`.
 
 Many more space operations can be found in `pypy/interpeter/baseobjspace.py` 
and
 `pypy/objspace/std/objspace.py`.
@@ -302,9 +302,9 @@
 
 .. py:function:: unicode_w(w_x)
 
-   Takes an application level :py:class:`unicode` and return an
+   Takes an application level :py:class::`unicode` and return an
    interpreter-level unicode string.  This method may disappear soon and
-   be replaced by :py:function:`text_w()`.
+   be replaced by :py:function::`text_w`.
 
 .. py:function:: float_w(w_x)
 
diff --git a/pypy/doc/release-pypy2.7-v5.4.0.rst 
b/pypy/doc/release-pypy2.7-v5.4.0.rst
--- a/pypy/doc/release-pypy2.7-v5.4.0.rst
+++ b/pypy/doc/release-pypy2.7-v5.4.0.rst
@@ -171,7 +171,7 @@
 * Performance improvements:
 
   * Add a before_call()-like equivalent before a few operations like
-   `malloc_nursery`, to move values from registers into other registers
+    `malloc_nursery`, to move values from registers into other registers
     instead of to the stack.
 
   * More tightly pack the stack when calling with `release gil`
diff --git a/pypy/doc/release-pypy2.7-v5.6.0.rst 
b/pypy/doc/release-pypy2.7-v5.6.0.rst
--- a/pypy/doc/release-pypy2.7-v5.6.0.rst
+++ b/pypy/doc/release-pypy2.7-v5.6.0.rst
@@ -140,7 +140,7 @@
     preamble
   * In JIT residual calls, if the called function starts with a fast-path like
     ``if x.foo != 0: return x.foo``, then inline the check before doing the
-     ``CALL``.
+    ``CALL``.
   * Ensure ``make_inputargs`` fails properly when given arguments with type 
     information
   * Makes ``optimiseopt`` iterative instead of recursive so it can be reasoned
diff --git a/pypy/doc/release-v5.8.0.rst b/pypy/doc/release-v5.8.0.rst
--- a/pypy/doc/release-v5.8.0.rst
+++ b/pypy/doc/release-v5.8.0.rst
@@ -10,8 +10,8 @@
 This new PyPy2.7 release includes the upstream stdlib version 2.7.13, and
 PyPy3.5 includes the upstream stdlib version 3.5.3.
 
-This release enables `profile guided optimization` of the base interpreter,
-which may make unjitted code run faster.
+This release enables link-time optimization and `profile guided optimization` 
+of the base interpreter, which may make unjitted code run faster.
 
 Please let us know if your use case is slow, we have ideas how to make things
 faster but need real-world examples (not micro-benchmarks) of problematic code.
diff --git a/pypy/doc/whatsnew-2.6.1.rst b/pypy/doc/whatsnew-2.6.1.rst
--- a/pypy/doc/whatsnew-2.6.1.rst
+++ b/pypy/doc/whatsnew-2.6.1.rst
@@ -6,6 +6,7 @@
 .. startrev: 91904d5c5188
 
 .. branch: use_min_scalar
+
 Correctly resolve the output dtype of ufunc(array, scalar) calls.
 
 .. branch: stdlib-2.7.10
@@ -15,6 +16,7 @@
 .. branch: issue2062
 
 .. branch: disable-unroll-for-short-loops
+
 The JIT no longer performs loop unrolling if the loop compiles to too much 
code.
 
 .. branch: run-create_cffi_imports
@@ -32,9 +34,11 @@
 ``lst[0]`` is still *not* the float ``42.0`` but the integer ``42``.)
 
 .. branch: cffi-callback-onerror
+
 Part of cffi 1.2.
 
 .. branch: cffi-new-allocator
+
 Part of cffi 1.2.
 
 .. branch: unicode-dtype
diff --git a/pypy/doc/whatsnew-4.0.0.rst b/pypy/doc/whatsnew-4.0.0.rst
--- a/pypy/doc/whatsnew-4.0.0.rst
+++ b/pypy/doc/whatsnew-4.0.0.rst
@@ -6,23 +6,28 @@
 .. startrev: 3a8f5481dab4
 
 .. branch: keys_with_hash
+
 Improve the performance of ``dict.update()`` and a bunch of methods from
 sets, by reusing the hash value stored in one dict when inspecting
 or changing another dict with that key.
 
 .. branch: optresult-unroll 
+
 A major refactoring of the ``ResOperations`` that kills Box. Also rewrote
 unrolling to enable future enhancements.  Should improve warmup time
 by 20% or so.
 
 .. branch: optimize-cond-call
+
 Optimize common sequences of operations like
 ``int_lt/cond_call`` in the JIT backends
 
 .. branch: missing_openssl_include
+
 Fix for missing headers in OpenBSD, already applied in downstream ports
 
 .. branch: gc-more-incremental
+
 Remove a source of non-incremental-ness in the GC: now
 ``external_malloc()`` no longer runs ``gc_step_until()`` any more. If there
 is a currently-running major collection, we do only so many steps
@@ -32,11 +37,13 @@
 keep adding up between them.
 
 .. branch: remember-tracing-counts
+
 Reenable jithooks
 
 .. branch: detect_egd2
 
 .. branch: shadowstack-no-move-2
+
 Issue #2141: fix a crash on Windows and OS/X and ARM when running
 at least 20 threads.
 
@@ -55,6 +62,7 @@
 floats, cf. issue #2148.
 
 .. branch: cffi-stdcall
+
 Win32: support ``__stdcall`` in CFFI.
 
 .. branch: callfamily
@@ -93,6 +101,7 @@
 .. branch: osx-libffi
 
 .. branch: lazy-fast2locals
-improve the performance of simple trace functions by lazily calling
+
+Improve the performance of simple trace functions by lazily calling
 ``fast2locals`` and ``locals2fast`` only if ``f_locals`` is actually accessed.
 
diff --git a/pypy/doc/whatsnew-5.0.0.rst b/pypy/doc/whatsnew-5.0.0.rst
--- a/pypy/doc/whatsnew-5.0.0.rst
+++ b/pypy/doc/whatsnew-5.0.0.rst
@@ -192,6 +192,7 @@
 Fix boolean-array indexing in micronumpy
 
 .. branch: numpy_partition
+
 Support ndarray.partition() as an app-level function numpy.core._partition_use,
 provided as a cffi wrapper to upstream's implementation in the pypy/numpy repo
 
diff --git a/pypy/doc/whatsnew-pypy2-5.3.0.rst 
b/pypy/doc/whatsnew-pypy2-5.3.0.rst
--- a/pypy/doc/whatsnew-pypy2-5.3.0.rst
+++ b/pypy/doc/whatsnew-pypy2-5.3.0.rst
@@ -29,6 +29,7 @@
 upstream numpy via cpyext, so we created (yet another) fork of numpy at 
 github.com/pypy/numpy with the needed changes. Among the significant changes 
 to cpyext:
+
   - allow c-snippet tests to be run with -A so we can verify we are compatible
   - fix many edge cases exposed by fixing tests to run with -A
   - issequence() logic matches cpython
diff --git a/pypy/doc/whatsnew-pypy2-5.4.0.rst 
b/pypy/doc/whatsnew-pypy2-5.4.0.rst
--- a/pypy/doc/whatsnew-pypy2-5.4.0.rst
+++ b/pypy/doc/whatsnew-pypy2-5.4.0.rst
@@ -6,10 +6,12 @@
 .. startrev: 873218a739f1
 
 .. 418b05f95db5
+
 Improve CPython compatibility for ``is``. Now code like ``if x is ():``
 works the same way as it does on CPython.  See 
http://pypy.readthedocs.io/en/latest/cpython_differences.html#object-identity-of-primitive-values-is-and-id
 .
 
 .. pull request #455
+
 Add sys.{get,set}dlopenflags, for cpyext extensions.
 
 .. branch: fix-gen-dfa
@@ -36,9 +38,11 @@
 compatible.
 
 .. branch: pyfile-tell
+
 Sync w_file with the c-level FILE* before returning FILE* in PyFile_AsFile
 
 .. branch: rw-PyString_AS_STRING
+
 Allow rw access to the char* returned from PyString_AS_STRING, also refactor
 PyStringObject to look like cpython's and allow subclassing PyString_Type and
 PyUnicode_Type
diff --git a/pypy/doc/whatsnew-pypy2-5.6.0.rst 
b/pypy/doc/whatsnew-pypy2-5.6.0.rst
--- a/pypy/doc/whatsnew-pypy2-5.6.0.rst
+++ b/pypy/doc/whatsnew-pypy2-5.6.0.rst
@@ -6,18 +6,22 @@
 .. startrev: 522736f816dc
 
 .. branch: rpython-resync
+
 Backport rpython changes made directly on the py3k and py3.5 branches.
 
 .. branch: buffer-interface
+
 Implement PyObject_GetBuffer, PyMemoryView_GET_BUFFER, and handles memoryviews
 in numpypy
 
 .. branch: force-virtual-state
+
 Improve merging of virtual states in the JIT in order to avoid jumping to the
 preamble. Accomplished by allocating virtual objects where non-virtuals are
 expected.
 
 .. branch: conditional_call_value_3
+
 JIT residual calls: if the called function starts with a fast-path
 like "if x.foo != 0: return x.foo", then inline the check before
 doing the CALL.  For now, string hashing is about the only case.
@@ -58,6 +62,7 @@
 
 
 .. fb6bb835369e
+
 Change the ``timeit`` module: it now prints the average time and the standard
 deviation over 7 runs by default, instead of the minimum. The minimum is often
 misleading.
@@ -69,9 +74,6 @@
 
 .. branch: Tiberiumk/fix-2412-1476011166874
 .. branch: redirect-assembler-jitlog
-
-
-
 .. branch: stdlib-2.7.12
 
 Update stdlib to version 2.7.12
diff --git a/pypy/doc/whatsnew-pypy3-5.8.0.rst 
b/pypy/doc/whatsnew-pypy3-5.8.0.rst
--- a/pypy/doc/whatsnew-pypy3-5.8.0.rst
+++ b/pypy/doc/whatsnew-pypy3-5.8.0.rst
@@ -6,6 +6,7 @@
 .. startrev: afbf09453369
 
 .. branch: mtest
+
 Use "<python> -m test" to run the CPython test suite, as documented by CPython,
 instead of our outdated regrverbose.py script.
 
_______________________________________________
pypy-commit mailing list
[email protected]
https://mail.python.org/mailman/listinfo/pypy-commit

Reply via email to