- README.txt: You're reading it.
- COPYING.txt: Public Domain Dedication and copyright details for
non-public-domain files (most are PD).
- FAQ.txt: Frequently Asked Questions (with answers!).
- RELEASE-NOTES.txt: Summary of the major changes in recent releases.
- HISTORY.txt: A detailed change log, for the current and all previous
project releases.
- BUGS.txt: Known bugs, and how to report a bug.
- THANKS.txt: List of contributors.
- setup.py: Installation script. See "Installation" below.
- install.py: Quick & dirty installation script. Just run it. For
any kind of customization or help though, setup.py must be used.
- docutils: The project source directory, installed as a Python
package.
- extras: Directory for third-party modules that Docutils depends on.
These are only installed if they're not already present.
- docs: The project documentation directory. Read docs/index.txt
for an overview.
- docs/user: The project user documentation directory. Contains the
following documents, among others:
- docs/user/tools.txt: Docutils Front-End Tools
- docs/user/latex.txt: Docutils LaTeX Writer
- docs/user/rst/quickstart.txt: A ReStructuredText Primer
- docs/user/rst/quickref.html: Quick reStructuredText (HTML only)
- docs/ref: The project reference directory.
docs/ref/rst/restructuredtext.txt is the reStructuredText
reference.
- licenses: Directory containing copies of license files for
non-public-domain files.
- tools: Directory for Docutils front-end tools. See
docs/user/tools.txt for documentation.
- test: Unit tests. Not required to use the software, but very useful
if you're planning to modify it. See Running the Test Suite
below.