/usr/share/perl5/XML/Compile/Schema/Instance.pod is in libxml-compile-perl 1.47-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 | =encoding utf8
=head1 NAME
XML::Compile::Schema::Instance - Represents one schema
=head1 SYNOPSIS
# Used internally by XML::Compile::Schema
my $schema = XML::Compile::Schema::Instance->new($xml);
=head1 DESCRIPTION
This module collect information from one schema, and helps to
process it.
=head1 METHODS
=head2 Constructors
=over 4
=item $obj-E<gt>B<new>($top, %options)
Get's the top of an XML::LibXML tree, which must be a schema element.
The tree is parsed: the information collected.
-Option --Default
attribute_form_default <undef>
element_form_default <undef>
filename undef
source undef
target_namespace <undef>
=over 2
=item attribute_form_default => 'qualified'|'unqualified'
=item element_form_default => 'qualified'|'unqualified'
Overrule the default as found in the schema. Many old schemas (like
WSDL11 and SOAP11) do not specify the default in the schema but only
in the text.
=item filename => FILENAME
When the source is some file, this is its name.
=item source => STRING
An indication where this information came from.
=item target_namespace => NAMESPACE
Overrule or set the target namespace.
=back
=back
=head2 Accessors
=over 4
=item $obj-E<gt>B<attributeGroups>()
Returns a list of all defined attribute groups.
=item $obj-E<gt>B<attributes>()
Returns a lost of all globally defined attribute names.
=item $obj-E<gt>B<complexTypes>()
Returns a list with all complexType names.
=item $obj-E<gt>B<element>($uri)
Returns one global element definition.
=item $obj-E<gt>B<elements>()
Returns a list of all globally defined element names.
=item $obj-E<gt>B<filename>()
=item $obj-E<gt>B<groups>()
Returns a list of all defined model groups.
=item $obj-E<gt>B<schema>()
=item $obj-E<gt>B<schemaInstance>()
=item $obj-E<gt>B<schemaNamespace>()
=item $obj-E<gt>B<sgs>()
Returns a HASH with the base-type as key and an ARRAY of types
which extend it.
=item $obj-E<gt>B<simpleTypes>()
Returns a list with all simpleType names.
=item $obj-E<gt>B<source>()
=item $obj-E<gt>B<targetNamespace>()
=item $obj-E<gt>B<tnses>()
A schema can defined more than one target namespace, where recent
schema spec changes provide a targetNamespace attribute.
=item $obj-E<gt>B<type>($uri)
Returns the type definition with the specified name.
=item $obj-E<gt>B<types>()
Returns a list of all simpleTypes and complexTypes
=back
=head2 Index
=over 4
=item $obj-E<gt>B<find>($kind, $fullname)
Returns the definition for the object of $kind, with $fullname.
example: of find
my $attr = $instance->find(attribute => '{myns}my_global_attr');
=item $obj-E<gt>B<importLocations>($ns)
Returns a list of all schemaLocations specified with the import $ns
(one of the values returned by L<imports()|XML::Compile::Schema::Instance/"Index">).
=item $obj-E<gt>B<imports>()
Returns a list with all namespaces which need to be imported.
=item $obj-E<gt>B<includeLocations>()
Returns a list of all schemaLocations which where specified with include
statements.
=item $obj-E<gt>B<printIndex>( [$fh], %options )
Prints an overview over the defined objects within this schema to the
selected $fh.
-Option --Default
kinds <all>
list_abstract <true>
=over 2
=item kinds => KIND|ARRAY-of-KIND
Which KIND of definitions would you like to see. Pick from
C<element>, C<attribute>, C<simpleType>, C<complexType>, C<attributeGroup>,
and C<group>.
=item list_abstract => BOOLEAN
Show abstract elements, or skip them (because they cannot be instantiated
anyway).
=back
=back
=head1 SEE ALSO
This module is part of XML-Compile distribution version 1.47,
built on October 11, 2014. Website: F<http://perl.overmeer.net/xml-compile/>
Other distributions in this suite:
L<XML::Compile>,
L<XML::Compile::SOAP>,
L<XML::Compile::WSDL11>,
L<XML::Compile::SOAP12>,
L<XML::Compile::SOAP::Daemon>,
L<XML::Compile::SOAP::WSA>,
L<XML::Compile::C14N>,
L<XML::Compile::WSS>,
L<XML::Compile::WSS::Signature>,
L<XML::Compile::Tester>,
L<XML::Compile::Cache>,
L<XML::Compile::Dumper>,
L<XML::Compile::RPC>,
L<XML::Rewrite>
and
L<XML::LibXML::Simple>.
Please post questions or ideas to the mailinglist at
F<http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/xml-compile> .
For live contact with other developers, visit the C<#xml-compile> channel
on C<irc.perl.org>.
=head1 LICENSE
Copyrights 2006-2014 by [Mark Overmeer]. For other contributors see ChangeLog.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See F<http://www.perl.com/perl/misc/Artistic.html>
|