diff --git a/Doc/Manual/Perl5.html b/Doc/Manual/Perl5.html index 507a83b18..b7cdaf0e5 100644 --- a/Doc/Manual/Perl5.html +++ b/Doc/Manual/Perl5.html @@ -1298,6 +1298,34 @@ nested namespace simply provide the fully qualified name in your NOTE: the double quotes are necessary.
++ Using the package option of the %module directive allows + you to specify what Perl namespace that the module will be living in when + installed. This is useful in the situation where a module maintainer + wants to split a large module into smaller pieces to make maintenance + easier, but doesn't want to have that affect the module name used by + applications. So for example, if I wanted to split XML::Xerces + into XML::Xerces::SAX, etc. , but I wanted all the applications + to be able to access the classes using the XML::Xerces namespace + I could use: + +
+ ++%module(package="XML::Xerces") "XML::Xerces::SAX ++
+ And now all the applications could use the class + XML::Xerces::SAXParser. Without the package directive + splitting the module would force applications to use the class + XML::Xerces::SAX::SAXParser. This could break compatibility for + existing applications that are already using the class under the name + XML::Xerces::SAXParser. +
+