Beginning with release 1.25, the DocBook XSL Stylesheets include a set of Java extensions for Saxon.

These extensions enable callouts, numbered program listings, and the direct inclusion of text:

@rem = '--*-Perl-*--
@echo off
perl.exe %_batchname %$
goto endofperl
@rem ';

# Compress mail...

require 'n:/home/nwalsh/lib/cygnus.pl';
require 'timelocal.pl';
use Cwd;

select (STDERR); $| = 1;
select (STDOUT); $| = 1;

@DIRS = ("/home/nwalsh/Mail");
while (@DIRS) {
    $dir = shift @DIRS;
    opendir (DIR, $dir);
    while ($fname = readdir(DIR)) {
        $file = "$dir/$fname";
        next if ! -d $file;
        next if $fname =~ /^\.\.?$/;

        print "$file\n";
        push (@DIRS, $file);
        &compress ($file);
    }
}

exit;
1

The prologue handles embedding a Perl script in a DOS batch file.

2

The goto statement, interpreted by the DOS batch file interpreter, skips over the body of the Perl script.

3

The require statement sources in external program fragments.

4

The use statement is similar, but has additional utility. It is a Perl5 function. (Note that this callout area specifies both a line and a column.)

5

This is a user subroutine call.

The extensions are included in the distribution in extensions/nwalsh.jar. Just make sure that jar file is in your CLASSPATH when you run Saxon.