UPDATE-PERL-SAX-PARSERS(8) - phpMan

UPDATE-PERL-SAX-PARSERS(8) Debian UPDATE-PERL-SAX-PARSERS(8)

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 di-
rectory /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/ParserDe-
tails.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 PRIOR-
ITIES 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 prior-
ity, 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 AT debian.org>

Niko Tyni <ntyni AT iki.fi>

This is free software; see the GNU General Public Licence version 2 or later for copying
conditions. There is no warranty.

0.3 Nov 2007 UPDATE-PERL-SAX-PARSERS(8)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-12-12 19:56 @18.191.238.37 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)