Bug#890838: duplicate "Example" in a docstring causes FTBFS due to sphinx in dependent package(s)

[Yaroslav Halchenko]

Package: python-sympy
Version: 1.1.1-3
Severity: important
Tags: upstream

I am trying to update  python-nipy package and it FTBFS due to docs
failing to build, because sphinx parses imported interfaces as well and pukes due to
https://github.com/numpy/numpydoc/issues/115
since there is two Examples within a single docstring 

$> dpkg -L python-sympy | xargs grep -A30 'Returns the atoms that form the current' 2>/dev/null
/usr/lib/python2.7/dist-packages/sympy/core/basic.py:        """Returns the atoms that form the current object.
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           By default, only objects that are truly atomic and can't
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           be divided into smaller pieces are returned: symbols, numbers,
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           and number symbols like I and pi. It is possible to request
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           atoms of any type, however, as demonstrated below.
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           Examples
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           ========
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           >>> from sympy import I, pi, sin
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           >>> from sympy.abc import x, y
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           >>> (1 + x + 2*sin(y + I*pi)).atoms()
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           {1, 2, I, pi, x, y}
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           If one or more types are given, the results will contain only
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           those types of atoms.
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           Examples
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           ========
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           >>> from sympy import Number, NumberSymbol, Symbol
/usr/lib/python2.7/dist-packages/sympy/core/basic.py-           >>> (1 + x + 2*sin(y + I*pi)).atoms

It was fixed upstream (attaching the commit patch, adjusted for 1 line offset
against our version).  I will prepare team upload now to fix it, hopefully
there is no objections

Cheers,

-- System Information:
Debian Release: buster/sid
  APT prefers unstable
  APT policy: (600, 'unstable'), (300, 'experimental'), (100, 'unstable-debug'), (100, 'stable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.14.0-3-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages python-sympy depends on:
ii  python         2.7.14-4
ii  python-mpmath  1.0.0-1

Versions of packages python-sympy recommends:
ii  ipython                 5.5.0-1
ii  python [python-ctypes]  2.7.14-4
ii  python-gmpy             1.17-3
ii  python-numpy            1:1.13.3-2
ii  python-pil              5.0.0-1
ii  python-pyglet           1.3.0-1

Versions of packages python-sympy suggests:
ii  dvipng               1.15-1
ii  python-sympy-doc     1.1.1-2
ii  texlive-fonts-extra  2017.20180103-2

-- no debconf information