Specify whether to add namespace prefixes to XML names appearing in the generated documentation.
As you may know, each XML name is not just a string. Rather, it is a vector of two values: { namespace URI, local name } |
All namespace prefixes used in the output documentation originate from some namespace URI/prefix bindings declared in the source WSDL/XSD files.
For a particular XML name, its namespace prefix is generated according to the binding for that namespace, which is found the nearest to the documentation context where that XML name appears.
Example:
Suppose you generate documentation for two XML schemas: schema1 and schema2.
The schema1 targets the namespace associated with 'namespace_uri_1'
URI,
which is bound to 'myns'
prefix.
This schema defines some MyType type component.
The schema2 targets a different namespace, however, it also uses MyType,
which it imports from the schema1.
To reference that type, the schema2 binds the 'namespace_uri_1'
to the prefix 'ns1'
, so MyType looks in it as:
ns1:MyType
In the parts of the documentation related to schema1 you will see:
myns:MyType
ns1:MyType