[Python-Dev] The docs, reloaded (original) (raw)

BJörn Lindqvist bjourne at gmail.com
Wed May 23 00:15:17 CEST 2007

> In your examples, I think the ReST version can be cleaned up quite a > bit. First by using the .. default-role:: literal directive so that > you can type foo() instead of using double back quotes and then you > can remove the redundant semantic markup. Like this:

I've already assigned the default role to var since it's used most frequently. Having two ways of spelling literal code is wasting markup, for me.

Reassign it then. :) var makes italic text but you can use var for that instead. Minor point I know, but it would make reading ReST source just a tiny bit easier.

-- mvh Björn

More information about the Python-Dev mailing list