On Thursday, October 7, 2004, 11:38:26 PM, Jamis wrote:

> Bil Kleb wrote:
>> Jamis Buck wrote:
>> 
>>>
>>> 1) Create a YAML document that contains your manual metadata, as well
>>> as the content of your manual in textile format. (A few gotchas to be
>>> avoided there, if you decide to go that route--just let me know.)
>> 
>> 
>> I am considering this route, please expand.

> Mostly, the gotchas have to do with some subtle interactions between
> YAML and Textile. For example, in strings, YAML will join lines, unless
> there are two newlines between them. Thus, when authoring your document,
> you have to add one more line than usual between paragraphs, or list
> elements, etc.

That kind of pernickety crap annoys me.  I'd rather put the Textile in
files, and refer to those files in the YAML.

Cheers,
Gavin