On Mon, Apr 26, 2010 at 11:26 PM, maxwell <maxw...@umiacs.umd.edu> wrote:
> On Mon, 26 Apr 2010 16:25:49 -0500, Grant Taylor
> <gtay...@riverviewtech.net> wrote:
>> Can you not have all your examples in separate source files?
>>
>> You might need a pre-processor to include them together when compiling
>> your source code. Can you compile your source code as is or are some of
>
>> the sections duplicate?
>
> Sounds like a job for Literate Programming. Instead of keeping your
> source code and examples in external file(s), keep them in your DocBook
> document, and extract them automagically to produce the source code in the
> programming language.
I can see how that could work in some simple cases. For anything other
than trivial programs, the edit-compile-run cycle would be very small
because of the inability to use an IDE or edit the source code
directly.
> The implementation that Norm Walsh did several years
> back, for an earlier version of DocBook, can easily be adapted to DB5. It
> assumes you only want to get a single source code file out, but could
> easily be adopted to allow for extracting ("tangling") multiple output
> files.
>
> We're using this for grammars of natural languages; the individual grammar
> rules scattered throughout our prose grammar get tangled into an XML
> document, which we further process into another target language. But the
> tangled doc can be in any programming language.
>
> Mike Maxwell
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
>
>
--
Ivan Ristic
ModSecurity Handbook [http://www.modsecurityhandbook.com]
SSL Labs [https://www.ssllabs.com/ssldb/]
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
