[RFC][PATCH] Produce HTML docs to upload on server

[Martin Pool]

On 16 Aug 2006, Alexander Belchenko <bialix at ukr.net> wrote:
> I do cross-platform rst2html launcher to use directly from Makefile.
> Therefore Makefile almost not changed.
> 
> To produce HTML docs to upload onto Canonical server use command:
> 
> make htmldocs
> 
> Produced docs will be placed to ./html_docs/ directory. This can be
> overridden by HTMLDIR variable inside Makefile.
> 
> To clear generated files one could use:
> 
> make clean-docs
> 
> Please review this patch and speak on.
> Is this enough for task "Put the bzr manual and bzr help output online"?
> Martin? Robert? What you think about this approach?

The changes to the Makefile to make it run on Windows look good.  

I don't really understand why you try to run rst2html in a subprocess.
If it's installed, won't the docutils package be necessarily installed
too?  OK, maybe the package will be not on the current Python path, but
for people who want to regenerate the documents it shouldn't be too much
to ask them to install it.

(Hm, does the tarball include generated html documents?  If not, it
probably should.)
-- 
Martin