1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
.\" -*- nroff -*-
.\" ----------------------------------------------------------------------
.\" Copyright (c) 2001-2003 Ardo van Rangelrooij
.\"
.\" This is free software; see the GNU General Public Licence version 2
.\" or later for copying conditions. There is NO warranty.
.\" ----------------------------------------------------------------------
.\"
.\" ----------------------------------------------------------------------
.TH UPDATE-PERL-SAX-PARSERS 8 "Nov 2007" "0.3" "Debian"
.\"
.\" ----------------------------------------------------------------------
.SH NAME
update-perl-sax-parsers \- (de)register Perl SAX parser modules
.\"
.\" ----------------------------------------------------------------------
.SH SYNOPSIS
.B update-perl-sax-parsers
.RI [ options ]
.B --add
.I parser_module
.PP
.B update-perl-sax-parsers
.RI [ options ]
.B --remove
.I parser_module
.PP
.B update-perl-sax-parsers
.RI [ options ]
.B --update
.\"
.\" ----------------------------------------------------------------------
.SH DESCRIPTION
.B update-perl-sax-parsers
inserts, updates and removes individual Perl SAX parser module info
files in the directory
.I /var/lib/libxml-sax-perl/ParserDetails.d
and the overall Perl SAX parser modules info file
.IR /etc/perl/XML/SAX/ParserDetails.ini .
.\"
.\" ----------------------------------------------------------------------
.SH OPTIONS
.TP
.B --add
Adds the per-module info file for the indicated Perl SAX parser module
to the directory
.IR /var/lib/libxml-sax-perl/ParserDetails.d .
.TP
.B --remove
Removes the per-module info file for Perl SAX parser module from the
directory
.IR /var/lib/libxml-sax-perl/ParserDetails.d .
.TP
.B --update
updates the overall Perl SAX parser modules info file
.IR /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
.B ucf(1) ,
unless the
.B --file
option is used. See also the
.B --ucf
option below.
.TP
.B --directory
When used with
.B --add
or with
.B --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
.B --update
indicates the ParserDetails.d directories to be used as source for
generating the ParserDetails.ini file. Default is
.IR /var/lib/libxml-sax-perl/ParserDetails.d .
.TP
.B --file
Indicates the ParserDetails.ini file up be updated. Default is
.IR /etc/perl/XML/SAX/ParserDetails.ini .
.TP
.B --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
.B 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
.B --directory
was specified, in which case the default is 0 (disabled.)
.TP
.B --ucf X
Forcibly enable (X != 0) or disable (X = 0) of
.B ucf(1) .
By default,
.B ucf(1)
will be used to manage the ParserDetails.ini file when
.B --file
is
.IR not
specified.
.TP
.B --quiet
Prevents any diagnostic output.
.TP
.B --test
Prevents the modification of any files and enables debugging mode.
.TP
.B --version
Displays the version information and exits.
.TP
.B --help
Display the usage information and exits.
.\"
.\" ----------------------------------------------------------------------
.SH PARSER PRIORITIES
Starting with version 0.3 of
.B 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
.B --update
is called, the parsers are listed in an order of ascending priority
into the
.IR ParserDetails.ini
file. The last parser in the file, ie. the one with the highest priority,
is the
.B 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.
.\"
.\" ----------------------------------------------------------------------
.SH 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.
.\"
.\" ----------------------------------------------------------------------
.SH "SEE ALSO"
.TP
/usr/share/doc/libxml-sax-perl/README.Debian
.\"
.\" ----------------------------------------------------------------------
.SH AUTHORS
Ardo van Rangelrooij <ardo@debian.org>
Niko Tyni <ntyni@iki.fi>
.\"
.\" ----------------------------------------------------------------------
.SH COPYRIGHT
Copyright \(co 2001-2003 Ardo van Rangelrooij
Copyright \(co 2007 Niko Tyni
.PP
This is free software; see the GNU General Public Licence version 2 or
later for copying conditions. There is
.I no
warranty.
.\"
.\" ----------------------------------------------------------------------
|
