.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" 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" ''
'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 turned on, 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.
.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
.el \{\
. de IX
..
.\}
.\"
.\" 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 "Test::XML 3pm"
.TH Test::XML 3pm "2009-07-02" "perl v5.14.2" "User Contributed Perl 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"
Test::XML \- Compare XML in perl tests
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 6
\& use Test::XML tests => 3;
\& is_xml( \*(Aq\*(Aq, \*(Aq\*(Aq ); # PASS
\& is_xml( \*(Aq\*(Aq, \*(Aq\*(Aq ); # FAIL
\& isnt_xml( \*(Aq\*(Aq, \*(Aq\*(Aq ); # PASS
\& is_well_formed_xml(\*(Aq\*(Aq); # PASS
\& is_well_formed_xml(\*(Aq\*(Aq); # FAIL
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module contains generic \s-1XML\s0 testing tools. See below for a list of
other modules with functions relating to specific \s-1XML\s0 modules.
.SH "FUNCTIONS"
.IX Header "FUNCTIONS"
.IP "is_xml ( \s-1GOT\s0, \s-1EXPECTED\s0 [, \s-1TESTNAME\s0 ] )" 4
.IX Item "is_xml ( GOT, EXPECTED [, TESTNAME ] )"
This function compares \s-1GOT\s0 and \s-1EXPECTED\s0, both of which are strings of
\&\s-1XML\s0. The comparison works semantically and will ignore differences in
syntax which are meaningless in xml, such as different quote characters
for attributes, order of attributes or empty tag styles.
.Sp
Returns true or false, depending upon test success.
.IP "isnt_xml( \s-1GOT\s0, \s-1MUST_NOT_BE\s0 [, \s-1TESTNAME\s0 ] )" 4
.IX Item "isnt_xml( GOT, MUST_NOT_BE [, TESTNAME ] )"
This function is similiar to \fIis_xml()\fR, except that it will fail if \s-1GOT\s0
and \s-1MUST_NOT_BE\s0 are identical.
.IP "is_well_formed_xml( \s-1XML\s0 [, \s-1TESTNAME\s0 ] )" 4
.IX Item "is_well_formed_xml( XML [, TESTNAME ] )"
This function determines whether or not a given \s-1XML\s0 string is parseable
as \s-1XML\s0.
.IP "is_good_xml ( \s-1XML\s0 [, \s-1TESTNAME\s0 ] )" 4
.IX Item "is_good_xml ( XML [, TESTNAME ] )"
This is an alias for \fIis_well_formed_xml()\fR.
.SH "NOTES"
.IX Header "NOTES"
There are several features of XML::SemanticDiff that may suprise you
if you are not aware of them. In particular:
.IP "\(bu" 4
Leading and trailing whitespace is always stripped, even in elements
with character content.
.IP "\(bu" 4
Whitespace inside character content is always stripped down to a single
space.
.IP "\(bu" 4
In mixed content elements (ie: an element with both text and elements
beneath it), all text is treated as a single value.
.IP "\(bu" 4
The order of elements is ignored.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Test::XML::SAX, Test::XML::Twig.
.PP
Test::More, XML::SemanticDiff.
.SH "AUTHOR"
.IX Header "AUTHOR"
Dominic Mitchell,
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright 2002 by semantico
.PP
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.