Custom Query (545 matches)

From Jeffrey Wildman:

Hi,

The subject may sound silly, but some explanation will help. The nodoc tarball (lemon-nodoc-1.2.3.tar.gz) is provided without pre-built documentation files, but I'd still like to build the documentation myself (for purposes of following up on packaging LEMON for Debian/Ubuntu? [1,2,3]). However, I'm experiencing some problems.

Issue 1: doc/references.bib is missing from the tarball. Without the file, I get errors regardless of which build system I use:

autotools: 'make html':

make[1]: * No rule to make target doc/references.bib', needed by references.dox'. Stop. make[1]: Leaving directory `/home/wraith/Downloads/lemon-1.2.3' make: * [html-recursive] Error 1

cmake: 'make html':

Scanning dependencies of target html Traceback (most recent call last):

File "/home/wraith/Downloads/lemon-1.2.3/scripts/bib2dox.py", line 813, in <module>

if name == "main": main()

File "/home/wraith/Downloads/lemon-1.2.3/scripts/bib2dox.py", line 811, in main

filehandler(filepath)

File "/home/wraith/Downloads/lemon-1.2.3/scripts/bib2dox.py", line 792, in filehandler

washeddata = bibtexwasher(filecont_source)

UnboundLocalError?: local variable 'filecont_source' referenced before assignment make[3]: * [doc/CMakeFiles/html] Error 1 make[2]: * [doc/CMakeFiles/html.dir/all] Error 2 make[1]: * [doc/CMakeFiles/html.dir/rule] Error 2 make: * [html] Error 2

Solution: (Note: the file doc/references.bib isn't present in the tarball lemon-1.2.3.tar.gz either!) I went to the main branch to find the file. Once it is placed in the doc folder, running 'make html' finishes with either autotools or cmake.

Issue 2: doc/template.h is missing from the tarball and causes warnings after after running 'make html'. From doc/doxygen.log:

autotools:

error: Tag file `/home/wraith/Downloads/lemon-1.2.3/doc/libstdc++.tag' does not exist or is not a file. Skipping it... /home/wraith/Downloads/lemon-1.2.3/doc/dirs.dox:28: warning: No matching directory found for command \dir doc/ /home/wraith/Downloads/lemon-1.2.3/doc/coding_style.dox:122: warning: included file template.h is not found. Check your EXAMPLE_PATH

cmake:

error: Tag file `/home/wraith/Downloads/lemon-1.2.3/build/doc/libstdc++.tag' does not exist or is not a file. Skipping it... /home/wraith/Downloads/lemon-1.2.3/doc/dirs.dox:28: warning: No matching directory found for command \dir doc/ /home/wraith/Downloads/lemon-1.2.3/build/doc/mainpage.dox:20: warning: found more than one \mainpage comment block! Skipping this block. /home/wraith/Downloads/lemon-1.2.3/doc/coding_style.dox:122: warning: included file template.h is not found. Check your EXAMPLE_PATH

Solution: Two of the relevant warnings are silenced by going to the main branch and copying template.h over to doc/ and rebuilding the documentation.

FYI, I am downloading the tarballs from here: http://lemon.cs.elte.hu/pub/sources/ ...and the files from here: http://lemon.cs.elte.hu/hg/lemon-main/file/9a716871028e/doc ...and I am running Ubuntu 11.10 Desktop 64-bit.

It just appears to be a tarball packaging issue, is this something that can be changed for future releases of LEMON?

Regards,

-Jeff

[1] http://lemon.cs.elte.hu/pipermail/lemon-user/2010-March/000165.html [2] ​http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=570930 [3] ​http://mentors.debian.net/package/coinor-lemon _ Lemon-devel mailing list Lemon-devel@… http://lemon.cs.elte.hu/mailman/listinfo/lemon-devel

The most important missing feature of the CMAKE based build environment is the generation of the release tarball. The good thing is that cmake needs basically no generated files (like the configure script and the Makefile.in files in case of Autotools). Still, it should generate

• cmake/version.cmake and
• the HTML documentation

and add them to the release tarbal.