# phpman > man > update-perl-sax-parsers(8)

[UPDATE-PERL-SAX-PARSERS(8)](https://www.chedong.com/phpMan.php/man/UPDATE-PERL-SAX-PARSERS/8/markdown)                     Debian                     [UPDATE-PERL-SAX-PARSERS(8)](https://www.chedong.com/phpMan.php/man/UPDATE-PERL-SAX-PARSERS/8/markdown)



## 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 direc‐
              tory _/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)](https://www.chedong.com/phpMan.php/man/ucf/1/markdown)** **,** 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/ParserDe__‐
              _tails.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  PRIORI‐
              TIES 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)](https://www.chedong.com/phpMan.php/man/ucf/1/markdown)** **.**  By default, [**ucf(1)](https://www.chedong.com/phpMan.php/man/ucf/1/markdown)** 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. Specifi‐
       cally, the file name will be "XX-[Some::Module](https://www.chedong.com/phpMan.php/perldoc/Some%3A%3AModule/markdown)", where XX denotes the priority and  [Some::Mod](https://www.chedong.com/phpMan.php/perldoc/Some%3A%3AMod/markdown)‐
       ule 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](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3ASAX/markdown) 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 un‐
       derlying 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](https://www.chedong.com/phpMan.php/perldoc/XML%3A%3ASAX/markdown) 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 con‐
       ditions.  There is _no_ warranty.



0.3                                           Nov 2007                    [UPDATE-PERL-SAX-PARSERS(8)](https://www.chedong.com/phpMan.php/man/UPDATE-PERL-SAX-PARSERS/8/markdown)