Issue
-----
Documentation of subprocess module claims that exceptions raised in child process will be re-raised in the parent process and will have child_traceback attribute set [1]. At least on Fedora Rawhide with python-3.6.2 this is not the case.


Reproducer
----------
$ cat preexec-exception.py
#!/usr/bin/env python3

import subprocess

class PreExecCallback:
    def __call__(self):
        raise Exception()

if __name__ == "__main__":
    p = PreExecCallback()

    try:
        subprocess.Popen(['/bin/echo', 'foobar'], preexec_fn=p)
    except subprocess.SubprocessError as e:
        if not hasattr(e, 'child_traceback'):
            print('BUG: Exception happened in child, but exception object does not have child_traceback attribute')

Actual result
-------------
$ ./preexec-exception.py 
BUG: Exception happened in child, but exception object does not have child_traceback attribute

Expected result
---------------
No output, because child_traceback attribute is present

Additional info
---------------
I happened to notice this while working with pre-exec callbacks. However, according to https://stackoverflow.com/questions/38433837/subprocess-child-traceback this seems to be the generic problem.

[1] https://docs.python.org/3/library/subprocess.html#exceptions

Documentation and implementation are out of sync. Python 3's subprocess module no longer sets child_traceback. I checked 3.3 to master. The assignment has been removed.

New changeset 47a2fced84605a32b79aa3ebc543533ad1a976a1 by Gregory P. Smith (Harmandeep Singh) in branch 'master':
bpo-31450: Remove documentation mentioning that subprocess's child_traceback is available with the parent process (GH-11422)
https://github.com/python/cpython/commit/47a2fced84605a32b79aa3ebc543533ad1a976a1

New changeset 47c035f3efa77a439967776b5b6ba11d010ce466 by Miss Islington (bot) in branch '3.7':
bpo-31450: Remove documentation mentioning that subprocess's child_traceback is available with the parent process (GH-11422)
https://github.com/python/cpython/commit/47c035f3efa77a439967776b5b6ba11d010ce466

messages: + msg302066
versions: + Python 3.7