[Python-checkins] python/dist/src/Doc/tut tut.tex,1.173,1.174

[fdrake@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/tut
In directory usw-pr-cvs1:/tmp/cvs-serv11060

Modified Files:
	tut.tex 
Log Message:
Describe __path__ along with the rest of the package description.
Closes SF bug #626554.


Index: tut.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/tut/tut.tex,v
retrieving revision 1.173
retrieving revision 1.174
diff -C2 -d -r1.173 -r1.174
*** tut.tex	10 Oct 2002 18:24:54 -0000	1.173
--- tut.tex	22 Oct 2002 21:00:44 -0000	1.174
***************
*** 2673,2677 ****
  is executed.  (This also works when \code{__all__} is defined.)
  
! Note that in general the practicing of importing * from a module or
  package is frowned upon, since it often causes poorly readable code.
  However, it is okay to use it to save typing in interactive sessions,
--- 2673,2677 ----
  is executed.  (This also works when \code{__all__} is defined.)
  
! Note that in general the practice of importing \code{*} from a module or
  package is frowned upon, since it often causes poorly readable code.
  However, it is okay to use it to save typing in interactive sessions,
***************
*** 2713,2716 ****
--- 2713,2727 ----
  %because of its awkwardness; since most packages will have a relative
  %shallow substructure, this is no big loss.)
+ 
+ \subsection{Packages in Multiple Directories}
+ 
+ Packages support one more special attribute, \member{__path__}.  This
+ is initialized to be a list containing the name of the directory
+ holding the package's \file{__init__.py} before the code in that file
+ is executed.  This variable can be modified; doing so affects future
+ searches for modules and subpackages contained in the package.
+ 
+ While this feature is not often needed, it can be used to extend the
+ set of modules found in a package.