README: Python Docstring Processing System


David Goodger





Thank you for downloading the Python Docstring Processing System project arhive. Development has been transferred to the Docutils project. As this is a work in progress, please check the project web site for updated working files.

To run the code, Python 2.0 or later must already be installed. You can get Python from You will also need the latest reStructuredText package, available from

Project Files & Directories


The first step is to expand the .tar.gz archive. It contains a distutils setup file "". OS-specific installation instructions follow.

Linux, Unix, MacOS X

  1. Open a shell.

  2. Go to the directory created by expanding the archive:

    cd <archive_directory_path>
  3. Install the package:

    python install

    If the python executable isn't on your path, you'll have to specify the complete path, such as /usr/local/bin/python. You may need root permissions to complete this step.

You can also just run; it does the same thing.


  1. Open a DOS box (Command Shell, MSDOS Prompt, or whatever they're calling it these days).

  2. Go to the directory created by expanding the archive:

    cd <archive_directory_path>
  3. Install the package:

    <path_to_python.exe>\python install

If your system is set up to run Python when you double-click on .py files, you can run to do the same as the above.


  1. Open the folder containing the expanded archive.

  2. Double-click on the file "", which should be a "Python module" file.

    If the file isn't a "Python module", the line endings are probably also wrong, and you will need to set up your system to recognize ".py" file extensions as Python files. See for detailed instructions. Once set up, it's easiest to start over by expanding the archive again.

  3. The distutils options window will appear. From the "Command" popup list choose "install", click "Add", then click "OK".

If is a "Python module" (see step 2 above if it isn't), you can run it instead of the above. The distutils options window will not appear.


The package modules are mostly in their infancy, continually growing and evolving. The module evolution is being driven by the reStructuredText parser project; see The dps.statemachine module is usable independently. It contains extensive inline documentation (in reStructuredText format).

The specs, the package structure, and the skeleton modules may also be of interest to you. Contributions are welcome!