Man Linux: Main Page and Category List

NAME

       update-python-modules - byte-compile python modules

SYNOPSIS

       update-python-modules [options] [package.public [...]]

DESCRIPTION

       The update-python-modules command is part of the python-support bundle.

       update-python-modules is responsible for the byte-compilation of python
       modules.  When  used  in  byte-compilation  mode,  it will byte-compile
       modules references in the files given on the command line. When used in
       installation  mode,  it  will byte-compile them once for each installed
       python version, and will make them available for all of them.

       At each invocation, with or  without  arguments,  update-python-modules
       will  check  for  installed  python  versions, and will build or remove
       modules according to new or removed versions since the last time it was
       run.

ARGUMENTS

       Arguments    must    be   files   or   directories   located   in   the
       /usr/share/python-support directory. Depending on their extension, they
       are treated differently.

       package.public
              A file listing public modules to install for each version. These
              modules must lie in /usr/share/pyshared or /usr/lib/pyshared.

       package.private
              A file listing private modules to byte-compile  for  one  Python
              version.

       package/
              A legacy directory hierarchy of public modules. The C extensions
              and portions that change with the Python version are to be found
              in /usr/lib/python-support/pythonX.Y/package/.

       package.dirs
              A legacy file listing directories where to find private modules.

OPTIONS

       -h, --help
              Show summary of options.

       -v, --verbose
              Detail all actions while they are performed.

       -b, --bytecompile
              Only accept to work on private modules. When given this  option,
              update-python-modules  will  fail if passed references to public
              modules.

       -i, --install
              Only accept to work on private modules. When given this  option,
              update-python-modules  will  fail if passed references to public
              modules.

       -c, --clean
              Clean modules instead of installing them.

       -a, --rebuild-all
              Rebuild all private modules. This is necessary when the  default
              python version was changed, for example.

       -f, --force-rebuild-all
              Clean all modules (public and private), and rebuild them.

FILES

       /usr/lib/pymodules/pythonX.Y/
              These  directories contain the byte-compiled modules for version
              pythonX.Y.

SEE ALSO

       /usr/share/doc/python-support/README.gz

AUTHOR

       Josselin Mouette <joss@debian.org>.

                                  18 Feb 2009