.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "XMLSpecContainer 3pm"
.TH XMLSpecContainer 3pm "2020-07-07" "Lire 2.1.1" "LogReport's Lire Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Lire::XMLSpecContainer \- Base clase for XML report and filter specifications
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use base qw/Lire::XMLSpecContainer/;
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This is the base class for Lire::ReportSpec and Lire::FilterSpec which
are \s-1XML\s0 specifications used to compute reports. This man page document
the attributes common to both type of specification.
.ie n .SS "id( [ $new_id ] )"
.el .SS "id( [ \f(CW$new_id\fP ] )"
.IX Subsection "id( [ $new_id ] )"
Returns the type id of this specification. It \f(CW$new_id\fR is set, it will
change the id of the specification.
.ie n .SS "superservice( [ $new_superservice ] )"
.el .SS "superservice( [ \f(CW$new_superservice\fP ] )"
.IX Subsection "superservice( [ $new_superservice ] )"
Returns the superservice (aka base \s-1DLF\s0 schema) used by this
specification. It \f(CW$new_superservice\fR is set, it will change the
superservice of the specification.
.ie n .SS "schema( [ $new_schema ] )"
.el .SS "schema( [ \f(CW$new_schema\fP ] )"
.IX Subsection "schema( [ $new_schema ] )"
Returns the Lire::DLfSchema object used by this specification. This
can be the superservice or any of its Lire::ExtendedSchema or
Lire::DerivedSchema.
.PP
If \f(CW$new_schema\fR is a string, the specification's schema will be changed
to that schema. If \f(CW$new_schema\fR is undef, the base DlfSchema (aka
superservice) will be used.
.ie n .SS "joined_schemas( [ $new_schemas ] )"
.el .SS "joined_schemas( [ \f(CW$new_schemas\fP ] )"
.IX Subsection "joined_schemas( [ $new_schemas ] )"
Returns as an array reference, the list of schemas that are joined in
this specification.
.PP
If \f(CW$new_schemas\fR is set, the list of joined schemas will be changed to
that list. This is an array reference of schema name. All of these
schemas should be join compatible with the schema specified in the
\&\fBschema()\fR attribute.
.SS "\fBschemas()\fP"
.IX Subsection "schemas()"
Returns in an array reference all the schemas used by this
specification. This will include the base schema as well as any
joined schemas.
.ie n .SS "has_field( $name )"
.el .SS "has_field( \f(CW$name\fP )"
.IX Subsection "has_field( $name )"
Returns whether the field named \f(CW$name\fR is available in this
specification's schema or any of its joined schema.
.ie n .SS "field( $name )"
.el .SS "field( \f(CW$name\fP )"
.IX Subsection "field( $name )"
Returns the Lire::Field object named \f(CW$name\fR present in one of
the specification's joined schema.
.ie n .SS "title( [ $new_title ]"
.el .SS "title( [ \f(CW$new_title\fP ]"
.IX Subsection "title( [ $new_title ]"
This method returns the title of this specification. If \f(CW$new_title\fR is
set, the specification's title will be changed to that value.
.PP
The returned value is localized if a translation string is available.
The domain used for translation is 'lire\-<superservice'.
.ie n .SS "description( [ $new_description ]"
.el .SS "description( [ \f(CW$new_description\fP ]"
.IX Subsection "description( [ $new_description ]"
This method returns the description of this specification. If
\&\f(CW$new_description\fR is set, the specification's description will be
changed to that value. That description is a DocBook string describing
the specification's purpose.
.PP
The returned value is localized if a translation string is available.
The domain used for translation is 'lire\-<superservice'.
.ie n .SS "display_title( [ $new_title ]"
.el .SS "display_title( [ \f(CW$new_title\fP ]"
.IX Subsection "display_title( [ $new_title ]"
This method returns the title that will be displayed in the generated
specification. This value can contains reference to the
specification's parameters using the '$name' syntax.
.PP
If \f(CW$new_title\fR is set, the specification's display title will be changed
to that value.
.PP
The returned value is localized if a translation string is available.
The domain used for translation is 'lire\-<superservice'.
.ie n .SS "display_description( [ $new_description ]"
.el .SS "display_description( [ \f(CW$new_description\fP ]"
.IX Subsection "display_description( [ $new_description ]"
This method returns the description that will be displayed in the
generated report. This value can contains reference to the
specification's parameters using the '$name' syntax.
.PP
If \f(CW$new_description\fR is set, the specification's description will be
changed to that value. That description is a DocBook string describing
the specification's purpose.
.PP
The returned value is localized if a translation string is available.
The domain used for translation is 'lire\-<superservice'.
.SS "\fBexpanded_display_title()\fP"
.IX Subsection "expanded_display_title()"
Returns \fBdisplay_title()\fR with parameters reference expanded.
.SS "\fBexpanded_display_description()\fP"
.IX Subsection "expanded_display_description()"
Returns \fBdisplay_description()\fR with parameters reference expanded.
.ie n .SS "print( $fh )"
.el .SS "print( \f(CW$fh\fP )"
.IX Subsection "print( $fh )"
Prints this specification as \s-1XML\s0 on \f(CW$fh\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.Vb 1
\& Lire::ReportSpec(3pm), Lire::FilterSpec(3pm), Lire::XMLSpecParser(3pm)
.Ve
.SH "AUTHORS"
.IX Header "AUTHORS"
.Vb 2
\&  Francis J. Lacoste <flacoste@logreport.org>
\&  Wolfgang Sourdeau <wolfgang@logreport.org>
.Ve
.SH "VERSION"
.IX Header "VERSION"
\&\f(CW$Id:\fR XMLSpecContainer.pm,v 1.41 2006/07/23 13:16:30 vanbaal Exp $
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2001\-2004 Stichting LogReport Foundation LogReport@LogReport.org
.PP
This file is part of Lire.
.PP
Lire is free software; you can redistribute it and/or modify
it under the terms of the \s-1GNU\s0 General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0  See the
\&\s-1GNU\s0 General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License
along with this program (see \s-1COPYING\s0); if not, check with
http://www.gnu.org/copyleft/gpl.html.