Try reading the README file under doc/sphinx: meg@meg-laptop:~/local/fenics/src/ufl/trunk$ cat doc/sphinx/README To build the documentation, run `scripts/makedoc` from the top-level UFL directory. Running `make html` directly from within this directory won't work (unless the makedoc script has been run first). -- Marie On 09/12/11 15:03, Andre Massing wrote: > Public bug reported: > > I tried either of these commands > make html > make dirhtml > make singlehtml > and could not build it because of the following error (from the error.log) : > # Sphinx version: 1.0.7 > # Python version: 2.7.0 > # Docutils version: 0.7 release > # Jinja2 version: 2.5.5 > Traceback (most recent call last): > File "/usr/lib/python2.7/site-packages/sphinx/cmdline.py", line 188, in main > app.build(force_all, filenames) > File "/usr/lib/python2.7/site-packages/sphinx/application.py", line 207, in build > self.builder.build_update() > File "/usr/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 198, in build_update > 'out of date' % len(to_build)) > File "/usr/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 254, in build > self.write(docnames, list(updated_docnames), method) > File "/usr/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 293, in write > doctree = self.env.get_and_resolve_doctree(docname, self) > File "/usr/lib/python2.7/site-packages/sphinx/environment.py", line 1117, in get_and_resolve_doctree > doctree = self.get_doctree(docname) > File "/usr/lib/python2.7/site-packages/sphinx/environment.py", line 1101, in get_doctree > f = open(doctree_filename, 'rb') > IOError: [Errno 2] No such file or directory: '/home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject/python-ufl/ufl-1.0_beta2/doc/sphinx/build/doctrees/index.doctree' > > > A more elaborate error message I got on the terminal: > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/algorithms.rst:97: > (ERROR/3) Unexpected indentation. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/algorithms.rst:360: > (WARNING/2) Literal block expected; none found. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:354: > (WARNING/2) Explicit markup ends without a blank line; unexpected > unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:532: > (ERROR/3) Unexpected indentation. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:546: > (WARNING/2) Definition list ends without a blank line; unexpected > unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:549: > (WARNING/2) Definition list ends without a blank line; unexpected > unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:550: > (WARNING/2) Block quote ends without a blank line; unexpected unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:560: > (ERROR/3) Unexpected indentation. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:574: > (WARNING/2) Definition list ends without a blank line; unexpected > unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:577: > (WARNING/2) Definition list ends without a blank line; unexpected > unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:578: > (WARNING/2) Block quote ends without a blank line; unexpected unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:544: > (ERROR/3) Undefined substitution referenced: "c|c|c|c". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/examples.rst:572: > (ERROR/3) Undefined substitution referenced: "c|c|c|c". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:227: > (WARNING/2) Inline literal start-string without end-string. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:679: > (ERROR/3) Unexpected indentation. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:680: > (WARNING/2) Block quote ends without a blank line; unexpected unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:836: > (ERROR/3) Unexpected indentation. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:837: > (WARNING/2) Block quote ends without a blank line; unexpected unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1268: > (WARNING/2) Inline interpreted text or phrase reference start-string > without end-string. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1564: > (WARNING/2) Inline interpreted text or phrase reference start-string > without end-string. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1597: > (WARNING/2) Inline literal start-string without end-string. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1640: > (WARNING/2) Explicit markup ends without a blank line; unexpected > unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1641: > (WARNING/2) Inline literal start-string without end-string. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1643: > (WARNING/2) Definition list ends without a blank line; unexpected > unindent. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1857: > (ERROR/3) Unexpected indentation. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:1881: > (WARNING/2) Inline emphasis start-string without end-string. > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:923: > (ERROR/3) Unknown target name: "a". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:923: > (ERROR/3) Unknown target name: "b". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:923: > (ERROR/3) Unknown target name: "a". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:923: > (ERROR/3) Unknown target name: "b". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:923: > (ERROR/3) Unknown target name: "a". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/form_language.rst:923: > (ERROR/3) Unknown target name: "b". > > /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject > /python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/user_manual.rst:45: > (WARNING/2) Inline literal start-string without end-string. > > WARNING: master file /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject/python-ufl/ufl-1.0_beta2/doc/sphinx/source/index.rst not found > looking for now-outdated files... none found > pickling environment... done > checking consistency... /home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject/python-ufl/ufl-1.0_beta2/doc/sphinx/source/user/user_manual.rst:: WARNING: document isn't included in any toctree > done > preparing documents... done > writing output... [ 11%] index > Exception occurred: > File "/usr/lib/python2.7/site-packages/sphinx/environment.py", line 1101, in get_doctree > f = open(doctree_filename, 'rb') > IOError: [Errno 2] No such file or directory: '/home/andre/Work/software/openSUSE/home:susetroll:sandbox:fenicsproject/python-ufl/ufl-1.0_beta2/doc/sphinx/build/doctrees/index.doctree' > The full traceback has been saved in /tmp/sphinx-err-EXOl8C.log, if you want to report the issue to the developers. > Please also report this if it was a user error, so that a better error message can be provided next time. > Either send bugs to the mailing list at, > or report them in the tracker at. Thanks! > make: *** [html] Error 1 > > ** Affects: ufl > Importance: Undecided > Status: New > > ** Summary changed: > > - documentation can not be built by sphinx > + documentation cannot be built by sphinx >