[Doc-SIG] Some random thoughts

David Ascher DavidA@ActiveState.com
Tue, 7 Mar 2000 16:26:22 -0800

> So perhaps what we need is a markup for code fragments (and
> I'd agree that an identifier could be seen as a special instance of a code
> fragment) and something else for genuine <code> markup.

Uh?  What's non-genuine code markup?

> My first complaint
> about StructuredText is that there isn't a protocol for escaping
> character;
> if there is (and there *has* to be in my opinion. It's possibly
> the biggest
> single ommission at the moment), then the problem goes away.

Fine.  How should that work?

> > Tibs tells me my habitual use of, e.g.
> >
> >     try: val = dict[key]
> >     except KeyError: val = default
> >
> > is unkind to other pythoneers.
> Yeah, that's fairly evil as is the whitespace abuse <wink>.

Especially because it should be spelled

  val = dict.get(key, default)