X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlmodlib.PL;h=c47affc608e0aefcfc69d75c1bcf8d31251e2d5d;hb=5a17876fec93d2d9eeb8689d271a67aeaf8a99e2;hp=e1ba87b52a28d5ec49a976081b8f2507add37ae4;hpb=309a139e25ad5904ea3df36d8c769e05300b3585;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlmodlib.PL b/pod/perlmodlib.PL index e1ba87b..c47affc 100644 --- a/pod/perlmodlib.PL +++ b/pod/perlmodlib.PL @@ -580,6 +580,12 @@ If adding a new module to a set, follow the original author's standards for naming modules and the interface to methods in those modules. +If developing modules for private internal or project specific use, +that will never be released to the public, then you should ensure +that their names will not clash with any future public module. You +can do this either by using the reserved Local::* category or by +using a category name that includes an underscore like Foo_Corp::*. + To be portable each component of a module name should be limited to 11 characters. If it might be used on MS-DOS then try to ensure each is unique in the first 8 characters. Nested modules make this easier.