[Docutils-users] Linux Installation Problem

[<cj...@sy...>]

In the .../site-packages/tools directory, I have the following command:
    ...  # buildhtml.py ../docs ../docs
and get the response below.  I tried the same thing in the archive 
directory, with a similar response.

How do I convert the basic .txt stuff to HTML?

Would it be possible to build this into the distutils activity?

Is it intended that the docultils package will be available as a Debian 
package later?

Thanks,

Colin W.

/// Processing directory: ../docs
    ::: Processing: index.txt
../docs/index.txt:0: (ERROR/3) Document empty; must have contents.
/// Processing directory: ../docs/api
    ::: Processing: cmdline-tool.txt
../docs/api/cmdline-tool.txt:0: (ERROR/3) Document empty; must have 
contents.
    ::: Processing: publisher.txt
../docs/api/publisher.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: runtime-settings.txt
../docs/api/runtime-settings.txt:0: (ERROR/3) Document empty; must have 
contents.
/// Processing directory: ../docs/dev
    ::: Processing: testing.txt
../docs/dev/testing.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: release.txt
../docs/dev/release.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: pysource.txt
../docs/dev/pysource.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: todo.txt
../docs/dev/todo.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: enthought-rfp.txt
../docs/dev/enthought-rfp.txt:0: (ERROR/3) Document empty; must have 
contents.
    ::: Processing: enthought-plan.txt
../docs/dev/enthought-plan.txt:0: (ERROR/3) Document empty; must have 
contents.
    ::: Processing: policies.txt
../docs/dev/policies.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: website.txt
../docs/dev/website.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: semantics.txt
../docs/dev/semantics.txt:0: (ERROR/3) Document empty; must have contents.
/// Processing directory: ../docs/dev/rst
    ::: Processing: problems.txt
../docs/dev/rst/problems.txt:0: (ERROR/3) Document empty; must have 
contents.
    ::: Processing: alternatives.txt
../docs/dev/rst/alternatives.txt:0: (ERROR/3) Document empty; must have 
contents.
/// Processing directory: ../docs/ref
    ::: Processing: transforms.txt
../docs/ref/transforms.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: doctree.txt
../docs/ref/doctree.txt:15: (ERROR/3) Error in "contents" directive:
invalid option data: extension option field body may contain
a single paragraph only (option "depth").

.. contents:: :depth: 1


../docs/ref/doctree.txt:222: (ERROR/3) Error in "contents" directive:
invalid option data: extension option field body may contain
a single paragraph only (option "depth").

.. contents:: :local:
              :depth: 1

../docs/ref/doctree.txt:4245: (ERROR/3) Error in "contents" directive:
invalid option data: extension option field body may contain
a single paragraph only (option "depth").

.. contents:: :local:
              :depth: 1

../docs/ref/doctree.txt:4495: (ERROR/3) Error in "contents" directive:
invalid option data: extension option field body may contain
a single paragraph only (option "depth").

.. contents:: :local:
              :depth: 1

../docs/ref/doctree.txt:0: (ERROR/3) Document empty; must have contents.
/// Processing directory: ../docs/ref/rst
    ::: Processing: restructuredtext.txt
../docs/ref/rst/restructuredtext.txt:0: (ERROR/3) Document empty; must 
have contents.
    ::: Processing: introduction.txt
../docs/ref/rst/introduction.txt:0: (ERROR/3) Document empty; must have 
contents.
    ::: Processing: roles.txt
../docs/ref/rst/roles.txt:0: (ERROR/3) Document empty; must have contents.
    ::: Processing: directives.txt
../docs/ref/rst/directives.txt:0: (ERROR/3) Document empty; must have 
contents.
/// Processing directory: ../docs/peps
    ::: Processing: pep-0256.txt
../docs/peps/pep-0256.txt:0: (ERROR/3) Document empty; must have contents.
DataError: Document does not begin with an RFC-2822 header; it is not a PEP.
Exiting due to error.  Use "--traceback" to diagnose.
Please report errors to <doc...@li...>.
Include "--traceback" output, Docutils version (0.3.5),
Python version (2.3.4), your OS type & version, and the
command line used.