[Doc-SIG] lightweight markup: bullets

[Tim Peters]

[Edward D. Loper]
> ...
> So the approach that I wanted to get peoples' opinion on is using
> bullets that look like::
>
>     <-> This is an unordered list item.
>     <1> This is an ordered list item.
>     <foo> This is a description list item.
>
> Here, I'm assuming that we're already using C<...> etc. to delimit
> colored regions, ...
> ...
> Is it too ugly?  Do you see any other problems with it?  Do you have
> any better ideas?

If we're reserving X<...> notation, let's use it uniformly:

     L<-> This is an unordered list item.
     L<1> This is an ordered list item.
     L<foo> This is a description list item.
     L<When C<x==0>> This is a descriptive item with embedded code in
     the description.

> ...
> The main disadvantage that I see is:
>     - It's uglier than just using '-' or '1.'.

Ya, and I'm uglier than my sisters, but that's no argument for letting them
write your docstrings <wink>.