NAME¶
update-perl-sax-parsers - (de)register Perl SAX parser modules
SYNOPSIS¶
update-perl-sax-parsers [
options]
--add
parser_module
update-perl-sax-parsers [
options]
--remove
parser_module
update-perl-sax-parsers [
options]
--update
DESCRIPTION¶
update-perl-sax-parsers inserts, updates and removes individual Perl SAX
parser module info files in the directory
/var/lib/libxml-sax-perl/ParserDetails.d and the overall Perl SAX
parser modules info file
/etc/perl/XML/SAX/ParserDetails.ini.
OPTIONS¶
- --add
- Adds the per-module info file for the indicated Perl SAX
parser module to the directory
/var/lib/libxml-sax-perl/ParserDetails.d.
- --remove
- Removes the per-module info file for Perl SAX parser module
from the directory /var/lib/libxml-sax-perl/ParserDetails.d.
- --update
- updates the overall Perl SAX parser modules info file
/etc/perl/XML/SAX/ParserDetails.ini. The modules will be listed in
an order of ascending priority. See the PARSER PRIORITIES section below.
The file will be managed with ucf(1) , unless the --file
option is used. See also the --ucf option below.
- --directory
- When used with --add or with --remove
indicates the ParserDetails.d directory to use for storing the per-module
Perl SAX parser module info file. When used one or more times with
--update indicates the ParserDetails.d directories to be used as
source for generating the ParserDetails.ini file. Default is
/var/lib/libxml-sax-perl/ParserDetails.d.
- --file
- Indicates the ParserDetails.ini file up be updated. Default
is /etc/perl/XML/SAX/ParserDetails.ini.
- --priority XX
- Specifies the priority of the SAX parser module to be added
removed. The priority will be encoded to the filename of the
ParserDetails.d entry. See the PARSER PRIORITIES section below.
This option was added in version 0.3 of update-perl-sax-parsers . Use
the value "0" to disable the encoding and match the behaviour of
earlier versions of the script.
The default priority value is 50, unless --directory was specified,
in which case the default is 0 (disabled.)
- --ucf X
- Forcibly enable (X != 0) or disable (X = 0) of ucf(1)
. By default, ucf(1) will be used to manage the
ParserDetails.ini file when --file is not specified.
- --quiet
- Prevents any diagnostic output.
- --test
- Prevents the modification of any files and enables
debugging mode.
- --version
- Displays the version information and exits.
- --help
- Display the usage information and exits.
PARSER PRIORITIES¶
Starting with version 0.3 of
update-perl-sax-parsers , the parsers are
assigned a priority value that is encoded into the names of the files in the
ParserDetails.d directory. Specifically, the file name will be
"XX-Some::Module", where XX denotes the priority and Some::Module is
the name of the parser module.
When
--update is called, the parsers are listed in an order of ascending
priority into the
ParserDetails.ini file. The last parser in the file,
ie. the one with the highest priority, is the
default XML::SAX parser.
Parsers with the same priority are sorted alphabetically by their name. This is
contrary to the behaviour of earlier versions, where the sort order was
undefined and depended on the underlying file system.
NOTE¶
Installing the original package from CPAN into /usr/local breaks the Debian
package, since the former is in Perl's @INC before the latter. So, please
don't do this.
If there's a new version of XML::SAX simply file a wishlist against the Debian
package and wait for the update.
SEE ALSO¶
- /usr/share/doc/libxml-sax-perl/README.Debian
AUTHORS¶
Ardo van Rangelrooij <ardo@debian.org>
Niko Tyni <ntyni@iki.fi>
COPYRIGHT¶
Copyright © 2001-2003 Ardo van Rangelrooij
Copyright © 2007 Niko Tyni
This is free software; see the GNU General Public Licence version 2 or later for
copying conditions. There is
no warranty.