Menu
▾
▴
[Docutils-users] include errors in buildhtml.py from snapshot, Mac OS X
|
From: <br...@or...> - 2003-01-09 08:35:10
|
Hi, I've just downloaded docutils from the snapshot at http://docutils.sf.net/docutils-snapshot.tgz and installed it into the python 2.2 that ships with Mac OS X 10.2.3, i.e. /usr/bin/python, following the instructions on http://docutils.sourceforge.net/README.html I noticed no problems during the install, and the test suite passes with no errors, but during "cd tools; ./buildhtml.py ../" I get some include errors -- output is below. (These occur before the test.txt file with its intentional errors is mentioned in the output.) There is also an error in the "./quicktest.py --version" command. (I took a look at some of the generated HTML and it looks correct to my untrained eye. See end of file for more pedantic details.) BTW, Thanks loads for docutils! It looks like it'll help a lot with some documentation I'm writing right now. (Not about anything related to Python, unfortunately.) Here are the relevant parts of my shell session, showing the include errors (about include4.txt, include5.txt, and include6.txt), and a few things I did to look into them. I didn't try to debug this, but I'll be glad to supply more info, or to try to debug it if someone more central to the project can't reproduce it. [!100] docutils/test % ./alltests.py .......................................... [rest of the 624 dots not shown] ---------------------------------------------------------------------- Ran 624 tests in 40.839s OK Elapsed time: 46.802 seconds [!101] docutils/test % cd ../tools [!105] docutils/tools % ./buildhtml.py ../ /// Processing directory: ../ ::: Processing .txt: COPYING.txt ::: Processing .txt: FAQ.txt ::: Processing .txt: HISTORY.txt ::: Processing .txt: README.txt /// Processing directory: ../build /// Processing directory: ../build/lib /// Processing directory: ../build/lib/docutils /// Processing directory: ../build/lib/docutils/languages /// Processing directory: ../build/lib/docutils/parsers /// Processing directory: ../build/lib/docutils/parsers/rst /// Processing directory: ../build/lib/docutils/parsers/rst/directives /// Processing directory: ../build/lib/docutils/parsers/rst/languages /// Processing directory: ../build/lib/docutils/readers /// Processing directory: ../build/lib/docutils/readers/python /// Processing directory: ../build/lib/docutils/transforms /// Processing directory: ../build/lib/docutils/writers /// Processing directory: ../docs ::: Processing .txt: tools.txt /// Processing directory: ../docs/rst ::: Processing .txt: quickstart.txt /// Processing directory: ../docs/rst/images /// Processing directory: ../docutils /// Processing directory: ../docutils/languages /// Processing directory: ../docutils/parsers /// Processing directory: ../docutils/parsers/rst /// Processing directory: ../docutils/parsers/rst/directives /// Processing directory: ../docutils/parsers/rst/languages /// Processing directory: ../docutils/readers /// Processing directory: ../docutils/readers/python /// Processing directory: ../docutils/transforms /// Processing directory: ../docutils/writers /// Processing directory: ../spec ::: Processing .txt: doctree.txt ::: Processing .txt: notes.txt ::: Processing .txt: pysource.txt ::: Processing .txt: semantics.txt ::: Processing .txt: transforms.txt ::: Processing PEPs: pep-0256.txt (text/x-rst) -> pep-0256.html pep-0257.txt (text/x-rst) -> pep-0257.html pep-0258.txt (text/x-rst) -> pep-0258.html pep-0287.txt (text/x-rst) -> pep-0287.html /// Processing directory: ../spec/howto ::: Processing .txt: i18n.txt ::: Processing .txt: rst-directives.txt /// Processing directory: ../spec/rst ::: Processing .txt: alternatives.txt ::: Processing .txt: directives.txt ::: Processing .txt: introduction.txt ::: Processing .txt: problems.txt ::: Processing .txt: reStructuredText.txt /// Processing directory: ../test /// Processing directory: ../test/test_parsers /// Processing directory: ../test/test_parsers/test_rst /// Processing directory: ../test/test_parsers/test_rst/test_directives ::: Processing .txt: include1.txt ::: Processing .txt: include2.txt ::: Processing .txt: include3.txt ../test/test_parsers/test_rst/test_directives/include3.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/include4.txt'. .. include:: includes/include4.txt SystemMessage: ../test/test_parsers/test_rst/test_directives/include3.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/include4.txt'. .. include:: includes/include4.txt input line 3 module /usr/lib/python2.2/site-packages/docutils/utils.py, line 172, function system_message Error (SystemMessage): ../test/test_parsers/test_rst/test_directives/include3.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/include4.txt'. .. include:: includes/include4.txt ::: Processing .txt: raw1.txt /// Processing directory: ../test/test_parsers/test_rst/test_directives/includes ::: Processing .txt: include4.txt ../test/test_parsers/test_rst/test_directives/includes/include4.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/include5.txt'. .. include:: include5.txt SystemMessage: ../test/test_parsers/test_rst/test_directives/includes/include4.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/include5.txt'. .. include:: include5.txt input line 3 module /usr/lib/python2.2/site-packages/docutils/utils.py, line 172, function system_message Error (SystemMessage): ../test/test_parsers/test_rst/test_directives/includes/include4.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/include5.txt'. .. include:: include5.txt ::: Processing .txt: include5.txt ../test/test_parsers/test_rst/test_directives/includes/include5.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/more/include6.txt'. .. include:: more/include6.txt SystemMessage: ../test/test_parsers/test_rst/test_directives/includes/include5.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/more/include6.txt'. .. include:: more/include6.txt input line 3 module /usr/lib/python2.2/site-packages/docutils/utils.py, line 172, function system_message Error (SystemMessage): ../test/test_parsers/test_rst/test_directives/includes/include5.txt:3: (SEVERE/4) Problems with "include" directive path: [Errno 2] No such file or directory: 'test/test_parsers/test_rst/test_directives/includes/more/include6.txt'. .. include:: more/include6.txt /// Processing directory: ../test/test_parsers/test_rst/test_directives/includes/more ::: Processing .txt: include6.txt /// Processing directory: ../test/test_readers /// Processing directory: ../test/test_readers/test_pep /// Processing directory: ../test/test_readers/test_python /// Processing directory: ../test/test_transforms /// Processing directory: ../tools ::: Processing .txt: test.txt ../tools/test.txt:87: (ERROR/3) Undefined substitution referenced: "problematic". ../tools/test.txt:293: (ERROR/3) Unknown target name: "5". ../tools/test.txt:302: (ERROR/3) Unknown target name: "nonexistent". ../tools/test.txt:327: (ERROR/3) Unknown target name: "hyperlink reference without a target". ../tools/test.txt:340: (ERROR/3) Unknown target name: "duplicate target names". /// Processing directory: ../tools/stylesheets [!106] docutils/tools % the files reported as missing do appear to be there, however: [!107] docutils/tools % cd .. [!108] python/docutils % l test/test_parsers/test_rst/test_directives/includes total 16 0 ./ 0 ../ 8 include4.txt 8 include5.txt 0 more/ [!109] python/docutils % the check for the version of docutils I'm running doesn't work: [!119] python/docutils % cd tools [!120] docutils/tools % ./quicktest.py --version Traceback (most recent call last): File "./quicktest.py", line 211, in ? main() File "./quicktest.py", line 195, in main inputFile, outputFile, outputFormat, optargs = getArgs() File "./quicktest.py", line 127, in getArgs return posixGetArgs(sys.argv[1:]) File "./quicktest.py", line 146, in posixGetArgs print >>sys.stderr, ('quicktest.py (Docutils %s)' AttributeError: 'module' object has no attribute '__version' Exit 1 Pedantic details: % ls -l docutils-snapshot.gz -rw-r--r-- 1 bruce admin 407326 Jan 8 19:31 docutils-snapshot.gz (timezone is PST; modtime is probably the time of downloading) (The file extension was apparently renamed from .tgz to .gz by Apple's new browser Safari when it downloaded the file.) % md5 docutils-snapshot.gz MD5 (docutils-snapshot.gz) = fd48f2fe3f0ffee04e00ea16cd4846a2 I was worried about long pathnames in the tarball being mangled by Stuffit Expander, which (so I've read) uses Apple's tar rather than gnutar, but I would have expected much worse errors if that had happened, and the include files reported missing are present according to my shell, as shown above. Just to make sure, I manually unpacked the archive with both tar and gnutar and got the same-sized results according to du and the exact same results according to diff -r, and diff -r of that docutils directory with the one produced by Stuffit Expander (and from which I installed, ran tests, and ran buildhtml) showed only the kind of extra files I'd expect (.html, .pyc, alltests.out). My system has several other pythons installed, but none of them are called 'python' on my shell path, so I don't think they can interfere. - Bruce Smith |
