Document $$ escape convention

[dclark@…]

As far as I can see the syntax of using double dollar sign ($$) in a genshi text template to indicate a single dollar sign ($) in the output text isn't documented, in for example:

• ​http://genshi.edgewall.org/wiki/Documentation/text-templates.html

The only way I found it was from knowledge that that convention is used in Makefiles sometimes; later I found these related tickets: #92 #117 and these mailing list posts:

• ​rendering HTML with embedded $'s
• ​Genshi templates and Mootools JS selectors

For the project I work on, Bcfg2, we've doc'ed this here:

• ​http://bcfg2.org/wiki/TGenshi#FAQs

This would seem to be a pretty common use case; for example with any type of file if you want to have subversion (svn) keywords like $Id$, you need to have $$Id$$ in the Genshi template file.

[cmlenz]

Docs added in [1013]. See Escaping in Templating Basics

[cmlenz]

Milestone 0.5.2 deleted