[CPS-devel] Building documentation for CPS products

[Dave Kuhlman]

On Thu, Jan 05, 2006 at 06:53:03PM +0100, M.-A. DARCHE wrote:
> Dave Kuhlman a écrit :

[snip]

>     visitor = self.translator_class(self.document)
>   File "/usr/lib/site-python/docutils/writers/html4css1.py", line 200, 
> in __init__
>     stylesheet = utils.get_stylesheet_reference(settings)
>   File "/usr/lib/site-python/docutils/utils.py", line 458, in 
> get_stylesheet_reference
>     assert not settings.stylesheet, \
> AssertionError: stylesheet and stylesheet_path are mutually exclusive.
> 
> 
> Please also note that PluggableUserFolder will not be part of CPS 3.4.x
> and thus should be removed from doc_tools/doc_directories.xml.
> But anyway the script should not die if a specified directory does not
> exist. A warning should be printed.
> 
> Let me know if I should give you more details or if I'm doing something
> wrong.

I've removed PluggableUserFolder from doc_directories.xml.

No, you did not do anything wrong.  And, the problem is not a
missing directory.  The problem is that the implementor (me) did
not test for another occurance of the same bug.  Here is another
patch:

    --- buildCPSdocs-old.py 2006-01-05 14:14:08.000000000 -0800
    +++ buildCPSdocs.py     2006-01-05 14:04:29.000000000 -0800
    @@ -332,6 +332,7 @@
         settings_overrides = {
             'generator': 1,
             'stylesheet_path': stylesheetPath,
    +        'stylesheet': None,
             'source_url': indexFileName,
             }
         publish_file(source_path='%s.txt' % path,

I apologize for the error and hope I did not waste too much of
your time.

For those who want to avoid fixing these errors, I've also put the
patched file here:

    http://www.rexx.com/~dkuhlman/doc_tools-1.0a.zip

Dave

-- 
Dave Kuhlman
http://www.rexx.com/~dkuhlman