This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author paul.j3
Recipients Antony.Lee, Elena.Oat, paul.j3, r.david.murray
Date 2017-09-02.15:48:44
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1504367325.42.0.694020212997.issue31330@psf.upfronthosting.co.za>
In-reply-to
Content
I've seen this before, either in another bug/issue or a Stackoverflow question.

The basic change in RawTextHelpFormatter is to turn off the line wrapping for texts like the description.  Multiple newlines are preserved at this step.

But after assembling all the pieces (usage, description, help, epilog) the formatter strips out duplicate newlines.  This is needed because the process of assembly freely inserts newlines between the pieces, regardless of whether they are blank or not.  It can't, or at least doesn't try to, distinguish between newlines within a block like the description, and newlines between blocks.

If someone could come up with a simple patch, great.  Or a simple change to the doc wording.  But I don't think this issue merits a larger fix.
History
Date User Action Args
2017-09-02 15:48:45paul.j3setrecipients: + paul.j3, r.david.murray, Antony.Lee, Elena.Oat
2017-09-02 15:48:45paul.j3setmessageid: <1504367325.42.0.694020212997.issue31330@psf.upfronthosting.co.za>
2017-09-02 15:48:45paul.j3linkissue31330 messages
2017-09-02 15:48:44paul.j3create