update-perl-sax-parsers

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  directory  /var/lib/libxml-sax-perl/ParserDe-
              tails.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 ParserDe-
              tails.d directory to use for storing  the  per-module  Perl  SAX
              parser module info file.  When used one or more times with --up-
              date 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 re-
              moved.  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  be-
              haviour of earlier versions of the script.

              The  default priority value is 50, unless --directory was speci-
              fied, in which case the default is 0 (disabled.)

       --ucf X
              Forcibly enable (X != 0) or disable (X = 0) of ucf(1) .  By  de-
              fault,  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 ascend-
       ing 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 (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 warranty.

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