Description
The Git.execute
method docstring includes this in the description of its output_stream
parameter:
Lines 990 to 991 in 1e044ea
I think this is referring to the subprocess
module, which could be clarified by changing subprocess
to :mod:`subprocess`
. But I'm not sure what issues this is referring to, or what information it seeks to impart to the reader.
To be clear, I'm not arguing that output_stream
shouldn't use a pipe. Instead, I think this part of the docstring should be clarified (and I am unsure how to do so).
If this intends to be general, and vagueness is acceptable, yet it is considered better to have this "due to" clause than simply remove it, and the issue really is in subprocess
itself, then it could be changed to:
due to limitations of :mod:`subprocess`
But I hope something more specific can be said.
The full context is:
Lines 987 to 994 in 1e044ea