[ python-Bugs-1682403 ] docutils clarification request for "rest"

[SourceForge.net]

Bugs item #1682403, was opened at 2007-03-16 15:58
Message generated for change (Comment added) made by collinwinter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1682403&group_id=5470

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
>Category: Python Library
Group: None
Status: Open
Resolution: None
>Priority: 3
Private: No
Submitted By: j vickroy (jvickroy)
>Assigned to: Martin v. Löwis (loewis)
Summary: docutils clarification request for "rest"

Initial Comment:
>From the definition of long_description:
 
 *'long string'*
     Multiple lines of plain text in reStructuredText format (see http://docutils.sf.net/).
 
in:

  http://docs.python.org/dist/meta-data.html

I incorrectly concluded that the the bdist_wininst installer would provide visual markup for long_description specified in restructured text.

According to Thomas Heller, that is not the case.

I wish to suggest adding this clarification to the distutils documentation perhaps in one or both of the following documents:

 http://docs.python.org/dist/postinstallation-script.html
 http://docs.python.org/dist/meta-data.html

Thanks,

-- jv

----------------------------------------------------------------------

>Comment By: Collin Winter (collinwinter)
Date: 2007-03-29 23:03

Message:
Logged In: YES 
user_id=1344176
Originator: NO

Martin, you handle a lot of the Windows-related code, right? Thoughts on
this?

----------------------------------------------------------------------

Comment By: j vickroy (jvickroy)
Date: 2007-03-29 10:26

Message:
Logged In: YES 
user_id=17213
Originator: YES

I expected bold font when using "**" markers, list bullets when using "*"
and "-" markers, etc. in the long_description text definition. 
Unfortunately, all of these markers are simply passed through unprocessed
in the long description text that appears in the opening window when
running the generated binary installer.

Does this help clarify the issue?

----------------------------------------------------------------------

Comment By: Collin Winter (collinwinter)
Date: 2007-03-28 19:46

Message:
Logged In: YES 
user_id=1344176
Originator: NO

I'm not quite sure what the problem is. What kind of "visual markup" did
you expect?

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1682403&group_id=5470