update-perl-sax-parsers - (de)register Perl SAX parser

          update-perl-sax-parsers [options] --add parser_module

          update-perl-sax-parsers [options] --remove parser_module

          update-perl-sax-parsers [options] --update

          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

               Adds the per-module info file for the indicated Perl
               SAX parser module to the directory /var/lib/libxml-

               Removes the per-module info file for Perl SAX parser
               module from the directory /var/lib/libxml-sax-

               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.

               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

               Indicates the ParserDetails.ini file up be updated.
               Default is /etc/perl/XML/SAX/ParserDetails.ini.

     Page 1                         0.3              (printed 5/23/22)


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

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

               Prevents any diagnostic output.

               Prevents the modification of any files and enables
               debugging mode.

               Displays the version information and exits.

               Display the usage information and exits.

          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.


     Page 2                         0.3              (printed 5/23/22)


          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.


          Ardo van Rangelrooij <ardo@debian.org>

          Niko Tyni            <ntyni@iki.fi>

          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-

     Page 3                         0.3              (printed 5/23/22)