Re: User-contributed recipes/documentation

On Sun, 31 May 2009, R. Tyler Ballance wrote:

> On Thu, May 28, 2009 at 04:02:05PM -0700, R. Tyler Ballance wrote:
>> Over the weekend I started working on writing some Cheetah documentation
>> in Cheetah and I suppose I should at least share my work (thus far).
>
> I started playing with Sphinx today (http://sphinx.pocoo.org/) and I
> think I might just move everything over into Sphinx land.
>
> I'm hoping to recreate the user's guide and get more comprehensive, and
> alive, documentation going with Sphinx (which primarily uses
> reStructured text, similar to Markdown).
>
> The little bit of code I toyed around with for the "current" recipes
> stuff linked in the parent post was fun, but unfortunately the macro
> support in Cheetah I don't think is good enough for me to use Cheetah to
> document itself.

It sounds like you were trying to use the macro stuff for something it's 
not intended for: embedding raw chunks of cheetah source that should not be 
parsed or compiled.  I'd suggest you look at the #raw directive or the 
compiler settings 'cheetahVarStartToken', 'directiveStartToken', etc.

As an aside, if no one is using the #macro stuff I wouldn't object to 
ripping it out.  I now have a much cleaner, simpler way of accomplishing 
what I wanted from it.

Tavis

------------------------------------------------------------------------------
OpenSolaris 2009.06 is a cutting edge operating system for enterprises 
looking to deploy the next generation of Solaris that includes the latest 
innovations from Sun and the OpenSource community. Download a copy and 
enjoy capabilities such as Networking, Storage and Virtualization. 
Go to: http://p.sf.net/sfu/opensolaris-get