UPDATE-PERL-SAX-PARSERS(8) (Nov 2007)  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 indi-
          vidual 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.

     Page 1                         0.3              (printed 5/23/22)

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

          --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 ver-
               sions of the script.

               The default priority value is 50, unless --directory
               was specified, in which case the default is 0 (dis-
               abled.)

          --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

     Page 2                         0.3              (printed 5/23/22)

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

          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 c 2001-2003 Ardo van Rangelrooij

          Copyright c 2007 Niko Tyni

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

     Page 3                         0.3              (printed 5/23/22)