(Greg already knows about this from private mail; 
this makes it "official".)

Long multi-word command-line options (begin 
with "--" and contain internal "-") inside text may be 
wrapped badly by textwrap.  For example, "--an-
option" may become "--\nan-option" or "--an-\
noption".  Perhaps words that begin with hyphens 
should not be wrapped at all?

Logged In: YES 
user_id=14422

Thanks for the reminder, David!

Fixed in Lib/textwrap.py rev 1.14.

Logged In: YES 
user_id=7733

There's still an edge case that gives poor results.  Try 
wrapping "--text--.".  It will wrap like "--text/--/.", leaving 
just the period (".") or the dashes & period ("--.") on the 
next line.  The latter may or may not be a problem, but 
I'd say wrapping just the sentence-ending period 
definitely *is* a problem.

A more plausible example is "what the--.".

Logged In: YES 
user_id=7733

More edge cases came up today.  These break at the 
slashes:

    "(--option)" --> "(/--/option)"

    "(--option-opt)" --> "(/--option-/opt)"

All but the last of these breaks are bad.

Perhaps TextWrapper should have a 
"break_whitespace_only" option?  This would be 
especially useful for technical text, where breaks at 
hyphens may change the text's meaning.

Logged In: YES 
user_id=14422

Finally!  Fixed in rev 1.26 of Lib/textwrap.py, with tests
in rev 1.21 of Lib/test/test_textwrap.py.