The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

export_swigged_symbols.pl - utility to extract package symbols from a SWIG generated output file and prepare them for exporting from the SWIG generated Perl module

SYNOPSIS

  export_swigged_symbols.pl --swig-docfile=<file> --pm-file=<file>
       [--help] [-?] [--man] [--verbose] [--Version]

Parses the ASCII documentation file generated by SWIG for package symbols. The symbols are separated in scalar variables, data field accessors (get/set) and general functions. This info is written into the given perl module (also generated by SWIG) in the EXPORT_TAGS hash under the keys scalars, accessors and functions respectively. In addition, all symbols are made available under the ALL key, and made available for exporting through the EXPORT_OK list.

The contents of the pm-file are thus altered.

OPTIONS

Following options and unique abbreviations of them are accepted:

--swig-docfile

name of the ASCII documentation file generated with SWIG

--pm-file

name of the perl module generated with SWIG

--help or -?

prints a brief help message and exits

--man

prints an extended help message and exits

--verbose

enables printing of info on the exported symbols to stderr

--Version

prints the version number and exits

ARGUMENTS

No arguments are accepted. All needed parameters are passed as options.

REMARKS

The current version of export_swigged_symbols.pl is designed for handling output of SWIG 1.1 (Build 883). It is not tested for other releases, but I assume it will work with SWIG 1.1p5 too.

More info on SWIG is available at http://www.swig.org/

RELEASE

$Id: export_swigged_symbols.pl,v 1.5 2000/09/11 13:39:44 verhaege Exp $

AUTHOR

Wim Verhaegen <wim.verhaegen@ieee.org>