{ "content": [ { "type": "text", "text": "# update-perl-sax-parsers (man)\n\n## NAME\n\nupdate-perl-sax-parsers - (de)register Perl SAX parser modules\n\n## SYNOPSIS\n\nupdate-perl-sax-parsers [options] --add parsermodule\nupdate-perl-sax-parsers [options] --remove parsermodule\nupdate-perl-sax-parsers [options] --update\n\n## DESCRIPTION\n\nupdate-perl-sax-parsers inserts, updates and removes individual Perl SAX parser module info\nfiles in the directory /var/lib/libxml-sax-perl/ParserDetails.d and the overall Perl SAX\nparser modules info file /etc/perl/XML/SAX/ParserDetails.ini.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (7 subsections)\n- **PARSER PRIORITIES**\n- **NOTE**\n- **SEE ALSO**\n- **AUTHORS**\n- **COPYRIGHT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "update-perl-sax-parsers", "section": "", "mode": "man", "summary": "update-perl-sax-parsers - (de)register Perl SAX parser modules", "synopsis": "update-perl-sax-parsers [options] --add parsermodule\nupdate-perl-sax-parsers [options] --remove parsermodule\nupdate-perl-sax-parsers [options] --update", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": "--remove", "arg": null, "description": "Removes the per-module info file for Perl SAX parser module from the directory /var/lib/libxml-sax-perl/ParserDetails.d." }, { "flag": "", "long": "--update", "arg": null, "description": "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." }, { "flag": "", "long": "--directory", "arg": null, "description": "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." }, { "flag": "", "long": "--priority", "arg": "XX", "description": "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.)" }, { "flag": "", "long": "--ucf", "arg": null, "description": "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." }, { "flag": "", "long": "--quiet", "arg": null, "description": "Prevents any diagnostic output. --test Prevents the modification of any files and enables debugging mode." }, { "flag": "", "long": "--version", "arg": null, "description": "Displays the version information and exits. --help Display the usage information and exits." } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 6, "subsections": [] }, { "name": "DESCRIPTION", "lines": 4, "subsections": [] }, { "name": "OPTIONS", "lines": 3, "subsections": [ { "name": "--remove", "lines": 3, "long": "--remove" }, { "name": "--update", "lines": 7, "long": "--update" }, { "name": "--directory", "lines": 9, "long": "--directory" }, { "name": "--priority XX", "lines": 10, "long": "--priority", "arg": "XX" }, { "name": "--ucf X", "lines": 3, "long": "--ucf" }, { "name": "--quiet", "lines": 4, "long": "--quiet" }, { "name": "--version", "lines": 4, "long": "--version" } ] }, { "name": "PARSER PRIORITIES", "lines": 13, "subsections": [] }, { "name": "NOTE", "lines": 6, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "AUTHORS", "lines": 4, "subsections": [] }, { "name": "COPYRIGHT", "lines": 10, "subsections": [] } ], "sections": { "NAME": { "content": "update-perl-sax-parsers - (de)register Perl SAX parser modules\n", "subsections": [] }, "SYNOPSIS": { "content": "update-perl-sax-parsers [options] --add parsermodule\n\nupdate-perl-sax-parsers [options] --remove parsermodule\n\nupdate-perl-sax-parsers [options] --update\n", "subsections": [] }, "DESCRIPTION": { "content": "update-perl-sax-parsers inserts, updates and removes individual Perl SAX parser module info\nfiles in the directory /var/lib/libxml-sax-perl/ParserDetails.d and the overall Perl SAX\nparser modules info file /etc/perl/XML/SAX/ParserDetails.ini.\n", "subsections": [] }, "OPTIONS": { "content": "--add Adds the per-module info file for the indicated Perl SAX parser module to the direc‐\ntory /var/lib/libxml-sax-perl/ParserDetails.d.\n", "subsections": [ { "name": "--remove", "content": "Removes the per-module info file for Perl SAX parser module from the directory\n/var/lib/libxml-sax-perl/ParserDetails.d.\n", "long": "--remove" }, { "name": "--update", "content": "updates the overall Perl SAX parser modules info file /etc/perl/XML/SAX/ParserDe‐\ntails.ini. The modules will be listed in an order of ascending priority. See the\nPARSER PRIORITIES section below.\n\nThe file will be managed with ucf(1) , unless the --file option is used. See also the\n--ucf option below.\n", "long": "--update" }, { "name": "--directory", "content": "When used with --add or with --remove indicates the ParserDetails.d directory to use\nfor storing the per-module Perl SAX parser module info file. When used one or more\ntimes with --update indicates the ParserDetails.d directories to be used as source for\ngenerating the ParserDetails.ini file. Default is /var/lib/libxml-sax-perl/ParserDe‐\ntails.d.\n\n--file Indicates the ParserDetails.ini file up be updated. Default is\n/etc/perl/XML/SAX/ParserDetails.ini.\n", "long": "--directory" }, { "name": "--priority XX", "content": "Specifies the priority of the SAX parser module to be added removed. The priority\nwill be encoded to the filename of the ParserDetails.d entry. See the PARSER PRIORI‐\nTIES section below.\n\nThis option was added in version 0.3 of update-perl-sax-parsers . Use the value \"0\"\nto disable the encoding and match the behaviour of earlier versions of the script.\n\nThe default priority value is 50, unless --directory was specified, in which case the\ndefault is 0 (disabled.)\n", "long": "--priority", "arg": "XX" }, { "name": "--ucf X", "content": "Forcibly enable (X != 0) or disable (X = 0) of ucf(1) . By default, ucf(1) will be\nused to manage the ParserDetails.ini file when --file is not specified.\n", "long": "--ucf" }, { "name": "--quiet", "content": "Prevents any diagnostic output.\n\n--test Prevents the modification of any files and enables debugging mode.\n", "long": "--quiet" }, { "name": "--version", "content": "Displays the version information and exits.\n\n--help Display the usage information and exits.\n", "long": "--version" } ] }, "PARSER PRIORITIES": { "content": "Starting with version 0.3 of update-perl-sax-parsers , the parsers are assigned a priority\nvalue that is encoded into the names of the files in the ParserDetails.d directory. Specifi‐\ncally, the file name will be \"XX-Some::Module\", where XX denotes the priority and Some::Mod‐\nule is the name of the parser module.\n\nWhen --update is called, the parsers are listed in an order of ascending priority into the\nParserDetails.ini file. The last parser in the file, ie. the one with the highest priority,\nis the default XML::SAX parser.\n\nParsers with the same priority are sorted alphabetically by their name. This is contrary to\nthe behaviour of earlier versions, where the sort order was undefined and depended on the un‐\nderlying file system.\n", "subsections": [] }, "NOTE": { "content": "Installing the original package from CPAN into /usr/local breaks the Debian package, since\nthe former is in Perl's @INC before the latter. So, please don't do this.\n\nIf there's a new version of XML::SAX simply file a wishlist against the Debian package and\nwait for the update.\n", "subsections": [] }, "SEE ALSO": { "content": "/usr/share/doc/libxml-sax-perl/README.Debian\n", "subsections": [] }, "AUTHORS": { "content": "Ardo van Rangelrooij \n\nNiko Tyni \n", "subsections": [] }, "COPYRIGHT": { "content": "Copyright © 2001-2003 Ardo van Rangelrooij\n\nCopyright © 2007 Niko Tyni\n\nThis is free software; see the GNU General Public Licence version 2 or later for copying con‐\nditions. There is no warranty.\n\n\n\n0.3 Nov 2007 UPDATE-PERL-SAX-PARSERS(8)", "subsections": [] } } } }