David Abrahams wrote:
> Joel de Guzman <[EMAIL PROTECTED]> writes:
>
>> No, you have good points. DocBook has the right facility already in the
>> form of <phrase role="some stuff">. Dave, I think Paul is right. We
>> do not need the Quickbook comments in the XML.
>
> Really? How are you suggesting I embed my testing instructions in a
> quickbook document, then?
I see that my post seem to be rather unclear. I meant to say that
both Qbk and BoostBook already have the facilities to do what you
want. We do not have to pass through Qbk comments through XML
because you can do it many ways. I was suggesting using DocBook
phrase and Qbk templates. Example:
[template %[body]<phrase role="literate-program">[body]</phrase>]
Then you can use the template:
[% some-lit-directives]
But then, I realized that you need to use XSLT to process the special
phrases, which I guess you would want to avoid. So, that might not
be a good suggestion. Still, we can go back to using xml comments,
or some other xml directives (below).
>> Also, now that I think about it some more, there's no harm
>> in writing:
>>
>> '''<!-- some doc-book comment here -->'''
>>
>> if you need some comments to pass through.
>
> I wouldn't want to have to do that for testing instructions. If you
> had to do that, nobody would use it. Frankly, I'd rather enter
> explicit XML:
>
> '''<literate code="compile()" />'''
>
> but that's nasty too.
Sure, but you can use templates to make the code prettier:
[template %[body]<literate code="[body]" />]
Then:
[% compile()]
How does that sound?
Regards,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys - and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
