[Doc-SIG] which characters to use for docstring markup

[Tim Peters]

[Edward D. Loper]
> ...
> 3. It makes much more sense to use "`" rather than "'" for ...

In the font I'm using to view this email, I can't see the difference between
those suggestions <wink>.

> ...
> I'm leaning towards using either::
>
>     C{code}, E{emph} etc.
>
> or::
>
>     `literal` and *one* *word* *emph* (and that's it)
>
> to color code in my markup.  Any comments?

I happen to like the former better, because it's extensible and unambiguous.
It wasn't suitable for Perl because, e.g., $C{$i} is legit Perl code.  And
they invented the C<$i> notation before "->" (as in $A->[$i]) thingies were
added to the language.  X{...} is never legit Python syntax today, and seems
very unlikely it ever will be.