Inserting a file using <!ENTITY>

[Stephen Wilhelm <swilhelm@theriver.com>]

Hello everyone.  I have a large document where I insert chapters using
<!ENTITY name SYSTEM "filename"> and I would like to do the same for
perl scripts.  I have tried using

    <programlisting>&program;</programlisting>

but DocBook wants to interpret the "&" characters inside the scripts.  I
can fix this by using a CDATA section like so:

    <programlisting>
    <![CDATA[
        # source code goes here
    ]]>
    </programlisting>

But then I can't use the &program; entity to insert my program.

Basically, I want a way to insert a perl script into the text without
modifying the script, keeping track of two versions of it (the script and
the DocBook version) and without running my DocBook source through a
preprocessor (which is what I'm doing now).

I was hoping that there might be an attribute to programlisting that would
tell it to read in a file, but this feature doesn't seem to exist.  Is
there another way to do this?


-- 
Stephen Wilhelm
    See my Gtk-Perl Tutorial:
    http://personal.riverusers.com/~swilhelm/gtkperl-tutorial/