From mboxrd@z Thu Jan  1 00:00:00 1970
From: Stephen Wilhelm <swilhelm@theriver.com>
To: DocBook Mailing List <docbook-tools-discuss@sourceware.cygnus.com>
Subject: Inserting a file using <!ENTITY>
Date: Sun, 29 Jul 2001 17:31:00 -0000
Message-id: <Pine.LNX.4.33.0107291729560.21482-100000@vorlon.theriver.com>
X-SW-Source: 2001-q3/msg00020.html

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/