perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/api/ModPerl Util.pod
Date Tue, 14 Sep 2004 19:13:40 GMT
stas        2004/09/14 12:13:40

  Modified:    src/docs/2.0/api/ModPerl Util.pod
  Log:
  unload_package: extra comments
  
  Revision  Changes    Path
  1.18      +12 -11    modperl-docs/src/docs/2.0/api/ModPerl/Util.pod
  
  Index: Util.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/Util.pod,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -u -r1.17 -r1.18
  --- Util.pod	9 Sep 2004 23:32:19 -0000	1.17
  +++ Util.pod	14 Sep 2004 19:13:40 -0000	1.18
  @@ -154,26 +154,27 @@
   
   =back
   
  -Unloading a Perl stash is a complicated business. This function tries
  -very hard to do the right thing. After calling this module, it should
  -be safe to C<use> a new version of the module.
  +Unloading a Perl stash (package) is a complicated business. This
  +function tries very hard to do the right thing. After calling this
  +function, it should be safe to C<use()> a new version of the module
  +that loads the wiped package.
   
  -References to module elements (function, variables, etc) that were
  -taken from outside the unloaded module will still be valid.
  +References to stash elements (functions, variables, etc.) taken from
  +outside the unloaded package will still be valid.
   
   This function may wipe off things loaded by other modules, if the
   latter have inserted things into the C<$stash> it was told to unload.
   
  -C<unload_package()> takes care not to delete sub-stashes when deleting
  -the requested stash. So for example if C<CGI> and C<CGI::Carp> are
  -loaded, calling C<unload_package('CGI')> won't affect C<CGI::Carp>.
  -
  -If the module's stash had a corresponding XS shared object loaded it
  -will be unloaded as well.
  +If a stash had a corresponding XS shared object (.so) loaded it will
  +be unloaded as well.
   
   If the stash had a corresponding entry in C<%INC>, it will be removed
   from there.
   
  +C<unload_package()> takes care to leave sub-stashes intact while
  +deleting the requested stash. So for example if C<CGI> and
  +C<CGI::Carp> are loaded, calling C<unload_package('CGI')> won't affect
  +C<CGI::Carp>.
   
   
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message