• Derek Parnell (54/54) Oct 03 2005 Just a couple of things I've learned the hard way that others might find

Derek Parnell <derek psych.ward> writes:

Just a couple of things I've learned the hard way that others might find
useful.

Firstly, the document processor color codes everything it sees as 'embedded
D source'. I didn't want this so I have a macro called 'CODE' defined to do
my formatting. 

However, I tripped over this usage ...


 $(CODE
 -------
 Line one
 -------
 Line two
 -------
 )

I was trying to format this text using my style sheet, however I got this
output ...

 $(CODE
 <pre class="d_code">Line one
 </pre>
 
 Line two
 <pre class="d_code"></pre>

It took me awhile to realize that DDoc sees everything *inside* pairs of
dashed lines as embedded code and thus applies its own DDOC_CODE macro. I
have three dashed lines here so the last one is not paired. Thus DDoc saw
it as equivalent to ...

 $(CODE
 $(DDOC_CODE
 Line one
 )
 Line two
 $(DDOC_CODE
 )

Making my CODE macro have a missing final parenthesis. My work around for
this was to create a DASHES macro so now I have ...

 $(CODE
 $(DASHES)
 Line one
 $(DASHES)
 Line two
 $(DASHES)
 )

which gives me 

 <pre class="code">----------
 Line one
 ----------
 Line two
 ----------
 </pre>

and that's fine now.

-- 
Derek
(skype: derek.j.parnell)
Melbourne, Australia
4/10/2005 4:25:00 PM