Docutils: Documentation Utilities

On Tue, Feb 28, 2012 at 08:48, ning zhou <nathon.py@...> wrote:
> I have met failed installation in windows with 2 computers.

Thanks for installing Docutils, and for letting us know about the
problems you saw.

The issues you report don't seem to be major. Docutils should work
fine on your systems.

> docutils: 0.8.1

This is an older version of Docutils. Could you try again with the
latest version? The errors may have already been fixed. The snapshot
is here: http://docutils.svn.sourceforge.net/viewvc/docutils/trunk/docutils/?view=tar

> .....Docutils> c:\python26\python.exe setup.py install >install.log

The install.log file looks fine. What was the problem with installation?

> .....Docutils\tools> c:\python26\python.exe buildhtml.py .. >build.log(After
> redirection to build.log, build.log not created. So the content of build.log
> is that I copied to this file from console. )

>From the portion sent, it looks like buildhtml.py is trying to build
HTML from the test files, which it shouldn't. This will be easy to
fix.

> .....Docutils\test>c:/python26/python.exe alltests.py >alltest.log (Same as
> build.log, the content of alltest.log is that I copied from console.)

Unfortunately only a portion of the output was in the alltest.log
file. Could you send the complete log?

The test failures that I see are trivial, just a matter of differences
in error output from different versions of Python.

The log indicated an error also, which could be more serious. Perhaps
we can tell more with the complete log.

> Above commands in DOS, are totally follow the installation instruction
> below http://zoomquiet.org/res/scrapbook/ZqFLOSS/data/20081218003820/#installation

Why are you using that location, and not
<http://docutils.sourceforge.net/README.html>.

> Same procedure in Ubuntu works.
>
> python version: 2.6
> OS: windows XP and 7
> docutils: 0.8.1
>
> Thanks!
>
> Ning

-- 
David Goodger <http://python.net/~goodger>

On Tue, Feb 28, 2012 at 23:09, ning zhou <nathon.py@...> wrote:
> All the logs attached, by the latest version.
> I think it should be a computer environment issue. Because same procedure
> works in Ubuntu.

Fixed the buildhtml.py issues.

Fixed the one real test failure, due to the way Windows deals with
absolute paths.

The remainder of the test failures are a result of a bug in Python,
http://bugs.python.org/issue6108, fixed in Python 2.6.5. From
<http://www.python.org/download/releases/2.6.7/NEWS.txt>:

"""
- Issue #6108: unicode(exception) and str(exception) should return the same
  message when only __str__ (and not __unicode__) is overridden in the
  subclass.
"""

I recommend you upgrade your Python.

> BTW,  C:\python26\python.exe buildhtml.py .. > buildhtml.log could not
> redirect the output on screen to the file  buildhtml.log. I have to copy it
> to the buildhtml.log.

That must be a Windows thing, nothing Docutils can do about it.

-- 
David Goodger <http://python.net/~goodger>

On Wed, Feb 29, 2012 at 10:54 PM, David Goodger <goodger@...> wrote:

> On Tue, Feb 28, 2012 at 23:09, ning zhou <nathon.py@...> wrote:>
> BTW,  C:\python26\python.exe buildhtml.py .. > buildhtml.log could not
> > redirect the output on screen to the file  buildhtml.log. I have to copy
> it
> > to the buildhtml.log.
>
> That must be a Windows thing, nothing Docutils can do about it.
>

Try "C:\python26\python.exe buildhtml.py .. 2>&1 > buildhtml.log" instead.
This redirects the error output to the normal output before sending it to a
file.

David

-- 
David Sankel
Sankel Software
 http://www.sankelsoftware.com

@David Goodger, I have tried 2.6.6, but same issue. I will ignore those
issues mentioned before, since buildhtml.py works for many existed .txt
files.
@David Sankel, Thanks for your tips.

2012/3/2 David Sankel <camior@...>

> On Wed, Feb 29, 2012 at 10:54 PM, David Goodger <goodger@...:
>
>> On Tue, Feb 28, 2012 at 23:09, ning zhou <nathon.py@...> wrote:>
>> BTW,  C:\python26\python.exe buildhtml.py .. > buildhtml.log could not
>> > redirect the output on screen to the file  buildhtml.log. I have to
>> copy it
>> > to the buildhtml.log.
>>
>> That must be a Windows thing, nothing Docutils can do about it.
>>
>
> Try "C:\python26\python.exe buildhtml.py .. 2>&1 > buildhtml.log" instead.
> This redirects the error output to the normal output before sending it to a
> file.
>
> David
>
> --
> David Sankel
> Sankel Software
> http://www.sankelsoftware.com
>