python/src/Doc/library/undoc.rst - toolchain/benchmark - Git at Google


 .. _undoc:

 ********************
 Undocumented Modules
 ********************

 Here's a quick listing of modules that are currently undocumented, but that
 should be documented.  Feel free to contribute documentation for them!  (Send
 via email to docs@python.org.)

 The idea and original contents for this chapter were taken from a posting by
 Fredrik Lundh; the specific contents of this chapter have been substantially
 revised.


 Miscellaneous useful utilities
 ==============================

 Some of these are very old and/or not very robust; marked with "hmm."

 :mod:`ihooks`
    --- Import hook support (for :mod:`rexec`; may become obsolete).  Removed in
    Python 3.x.


 Platform specific modules
 =========================

 These modules are used to implement the :mod:`os.path` module, and are not
 documented beyond this mention.  There's little need to document these.

 :mod:`ntpath`
    --- Implementation of :mod:`os.path` on Win32, Win64, WinCE, and OS/2 platforms.

 :mod:`posixpath`
    --- Implementation of :mod:`os.path` on POSIX.

 :mod:`bsddb185`
    --- Backwards compatibility module for systems which still use the Berkeley DB
    1.85 module.  It is normally only available on certain BSD Unix-based systems.
    It should never be used directly.


 Multimedia
 ==========

 :mod:`audiodev`
    --- Platform-independent API for playing audio data.  Removed in Python 3.x.

 :mod:`linuxaudiodev`
    --- Play audio data on the Linux audio device.  Replaced in Python 2.3 by the
    :mod:`ossaudiodev` module.  Removed in Python 3.x.

 :mod:`sunaudio`
    --- Interpret Sun audio headers (may become obsolete or a tool/demo).
    Removed in Python 3.x.

 :mod:`toaiff`
    --- Convert "arbitrary" sound files to AIFF files; should probably become a tool
    or demo.  Requires the external program :program:`sox`.  Removed in Python 3.x.


 .. _undoc-mac-modules:

 Undocumented Mac OS modules
 ===========================


 :mod:`applesingle` --- AppleSingle decoder
 ------------------------------------------

 .. module:: applesingle
    :platform: Mac
    :synopsis: Rudimentary decoder for AppleSingle format files.
    :deprecated:

 .. deprecated:: 2.6


 :mod:`buildtools` --- Helper module for BuildApplet and Friends
 ---------------------------------------------------------------

 .. module:: buildtools
    :platform: Mac
    :synopsis: Helper module for BuildApplet, BuildApplication and macfreeze.
    :deprecated:


 .. deprecated:: 2.4

 :mod:`cfmfile` --- Code Fragment Resource module
 ------------------------------------------------

 .. module:: cfmfile
    :platform: Mac
    :synopsis: Code Fragment Resource module.
    :deprecated:


 :mod:`cfmfile` is a module that understands Code Fragments and the accompanying
 "cfrg" resources. It can parse them and merge them, and is used by
 BuildApplication to combine all plugin modules to a single executable.

 .. deprecated:: 2.4

 :mod:`icopen` --- Internet Config replacement for :meth:`open`
 --------------------------------------------------------------

 .. module:: icopen
    :platform: Mac
    :synopsis: Internet Config replacement for open().
    :deprecated:


 Importing :mod:`icopen` will replace the built-in :meth:`open` with a version
 that uses Internet Config to set file type and creator for new files.

 .. deprecated:: 2.6


 :mod:`macerrors` --- Mac OS Errors
 ----------------------------------

 .. module:: macerrors
    :platform: Mac
    :synopsis: Constant definitions for many Mac OS error codes.
    :deprecated:


 :mod:`macerrors` contains constant definitions for many Mac OS error codes.

 .. deprecated:: 2.6


 :mod:`macresource` --- Locate script resources
 ----------------------------------------------

 .. module:: macresource
    :platform: Mac
    :synopsis: Locate script resources.
    :deprecated:


 :mod:`macresource` helps scripts finding their resources, such as dialogs and
 menus, without requiring special case code for when the script is run under
 MacPython, as a MacPython applet or under OSX Python.

 .. deprecated:: 2.6


 :mod:`Nav` --- NavServices calls
 --------------------------------

 .. module:: Nav
    :platform: Mac
    :synopsis: Interface to Navigation Services.
    :deprecated:


 A low-level interface to Navigation Services.

 .. deprecated:: 2.6


 :mod:`PixMapWrapper` --- Wrapper for PixMap objects
 ---------------------------------------------------

 .. module:: PixMapWrapper
    :platform: Mac
    :synopsis: Wrapper for PixMap objects.
    :deprecated:


 :mod:`PixMapWrapper` wraps a PixMap object with a Python object that allows
 access to the fields by name. It also has methods to convert to and from
 :mod:`PIL` images.

 .. deprecated:: 2.6


 :mod:`videoreader` --- Read QuickTime movies
 --------------------------------------------

 .. module:: videoreader
    :platform: Mac
    :synopsis: Read QuickTime movies frame by frame for further processing.
    :deprecated:


 :mod:`videoreader` reads and decodes QuickTime movies and passes a stream of
 images to your program. It also provides some support for audio tracks.

 .. deprecated:: 2.6


 :mod:`W` --- Widgets built on :mod:`FrameWork`
 ----------------------------------------------

 .. module:: W
    :platform: Mac
    :synopsis: Widgets for the Mac, built on top of FrameWork.
    :deprecated:


 The :mod:`W` widgets are used extensively in the :program:`IDE`.

 .. deprecated:: 2.6


 .. _obsolete-modules:

 Obsolete
 ========

 These modules are not normally available for import; additional work must be
 done to make them available.

 These extension modules written in C are not built by default. Under Unix, these
 must be enabled by uncommenting the appropriate lines in :file:`Modules/Setup`
 in the build tree and either rebuilding Python if the modules are statically
 linked, or building and installing the shared object if using dynamically-loaded
 extensions.

 .. (lib-old is empty as of Python 2.5)

    Those which are written in Python will be installed into the directory
    \file{lib-old/} installed as part of the standard library.  To use
    these, the directory must be added to \code{sys.path}, possibly using
    \envvar{PYTHONPATH}.

 :mod:`timing`
    --- Measure time intervals to high resolution (use :func:`time.clock`
    instead).  Removed in Python 3.x.


 SGI-specific Extension modules
 ==============================

 The following are SGI specific, and may be out of touch with the current version
 of reality.

 :mod:`cl`
    --- Interface to the SGI compression library.

 :mod:`sv`
    --- Interface to the "simple video" board on SGI Indigo (obsolete hardware).
    Removed in Python 3.x.

	.. _undoc:

	********************
	Undocumented Modules
	********************

	Here's a quick listing of modules that are currently undocumented, but that
	should be documented. Feel free to contribute documentation for them! (Send
	via email to docs@python.org.)

	The idea and original contents for this chapter were taken from a posting by
	Fredrik Lundh; the specific contents of this chapter have been substantially
	revised.


	Miscellaneous useful utilities
	==============================

	Some of these are very old and/or not very robust; marked with "hmm."

	:mod:`ihooks`
	--- Import hook support (for :mod:`rexec`; may become obsolete). Removed in
	Python 3.x.


	Platform specific modules
	=========================

	These modules are used to implement the :mod:`os.path` module, and are not
	documented beyond this mention. There's little need to document these.

	:mod:`ntpath`
	--- Implementation of :mod:`os.path` on Win32, Win64, WinCE, and OS/2 platforms.

	:mod:`posixpath`
	--- Implementation of :mod:`os.path` on POSIX.

	:mod:`bsddb185`
	--- Backwards compatibility module for systems which still use the Berkeley DB
	1.85 module. It is normally only available on certain BSD Unix-based systems.
	It should never be used directly.


	Multimedia
	==========

	:mod:`audiodev`
	--- Platform-independent API for playing audio data. Removed in Python 3.x.

	:mod:`linuxaudiodev`
	--- Play audio data on the Linux audio device. Replaced in Python 2.3 by the
	:mod:`ossaudiodev` module. Removed in Python 3.x.

	:mod:`sunaudio`
	--- Interpret Sun audio headers (may become obsolete or a tool/demo).
	Removed in Python 3.x.

	:mod:`toaiff`
	--- Convert "arbitrary" sound files to AIFF files; should probably become a tool
	or demo. Requires the external program :program:`sox`. Removed in Python 3.x.


	.. _undoc-mac-modules:

	Undocumented Mac OS modules
	===========================


	:mod:`applesingle` --- AppleSingle decoder
	------------------------------------------

	.. module:: applesingle
	:platform: Mac
	:synopsis: Rudimentary decoder for AppleSingle format files.
	:deprecated:

	.. deprecated:: 2.6


	:mod:`buildtools` --- Helper module for BuildApplet and Friends
	---------------------------------------------------------------

	.. module:: buildtools
	:platform: Mac
	:synopsis: Helper module for BuildApplet, BuildApplication and macfreeze.
	:deprecated:


	.. deprecated:: 2.4

	:mod:`cfmfile` --- Code Fragment Resource module
	------------------------------------------------

	.. module:: cfmfile
	:platform: Mac
	:synopsis: Code Fragment Resource module.
	:deprecated:


	:mod:`cfmfile` is a module that understands Code Fragments and the accompanying
	"cfrg" resources. It can parse them and merge them, and is used by
	BuildApplication to combine all plugin modules to a single executable.

	.. deprecated:: 2.4

	:mod:`icopen` --- Internet Config replacement for :meth:`open`
	--------------------------------------------------------------

	.. module:: icopen
	:platform: Mac
	:synopsis: Internet Config replacement for open().
	:deprecated:


	Importing :mod:`icopen` will replace the built-in :meth:`open` with a version
	that uses Internet Config to set file type and creator for new files.

	.. deprecated:: 2.6


	:mod:`macerrors` --- Mac OS Errors
	----------------------------------

	.. module:: macerrors
	:platform: Mac
	:synopsis: Constant definitions for many Mac OS error codes.
	:deprecated:


	:mod:`macerrors` contains constant definitions for many Mac OS error codes.

	.. deprecated:: 2.6


	:mod:`macresource` --- Locate script resources
	----------------------------------------------

	.. module:: macresource
	:platform: Mac
	:synopsis: Locate script resources.
	:deprecated:


	:mod:`macresource` helps scripts finding their resources, such as dialogs and
	menus, without requiring special case code for when the script is run under
	MacPython, as a MacPython applet or under OSX Python.

	.. deprecated:: 2.6


	:mod:`Nav` --- NavServices calls
	--------------------------------

	.. module:: Nav
	:platform: Mac
	:synopsis: Interface to Navigation Services.
	:deprecated:


	A low-level interface to Navigation Services.

	.. deprecated:: 2.6


	:mod:`PixMapWrapper` --- Wrapper for PixMap objects
	---------------------------------------------------

	.. module:: PixMapWrapper
	:platform: Mac
	:synopsis: Wrapper for PixMap objects.
	:deprecated:


	:mod:`PixMapWrapper` wraps a PixMap object with a Python object that allows
	access to the fields by name. It also has methods to convert to and from
	:mod:`PIL` images.

	.. deprecated:: 2.6


	:mod:`videoreader` --- Read QuickTime movies
	--------------------------------------------

	.. module:: videoreader
	:platform: Mac
	:synopsis: Read QuickTime movies frame by frame for further processing.
	:deprecated:


	:mod:`videoreader` reads and decodes QuickTime movies and passes a stream of
	images to your program. It also provides some support for audio tracks.

	.. deprecated:: 2.6


	:mod:`W` --- Widgets built on :mod:`FrameWork`
	----------------------------------------------

	.. module:: W
	:platform: Mac
	:synopsis: Widgets for the Mac, built on top of FrameWork.
	:deprecated:


	The :mod:`W` widgets are used extensively in the :program:`IDE`.

	.. deprecated:: 2.6


	.. _obsolete-modules:

	Obsolete
	========

	These modules are not normally available for import; additional work must be
	done to make them available.

	These extension modules written in C are not built by default. Under Unix, these
	must be enabled by uncommenting the appropriate lines in :file:`Modules/Setup`
	in the build tree and either rebuilding Python if the modules are statically
	linked, or building and installing the shared object if using dynamically-loaded
	extensions.

	.. (lib-old is empty as of Python 2.5)

	Those which are written in Python will be installed into the directory
	\file{lib-old/} installed as part of the standard library. To use
	these, the directory must be added to \code{sys.path}, possibly using
	\envvar{PYTHONPATH}.

	:mod:`timing`
	--- Measure time intervals to high resolution (use :func:`time.clock`
	instead). Removed in Python 3.x.


	SGI-specific Extension modules
	==============================

	The following are SGI specific, and may be out of touch with the current version
	of reality.

	:mod:`cl`
	--- Interface to the SGI compression library.

	:mod:`sv`
	--- Interface to the "simple video" board on SGI Indigo (obsolete hardware).
	Removed in Python 3.x.