[Lemon-devel] lemon-nodoc - missing doc/ files

Alpár Jüttner alpar at cs.elte.hu
Tue Dec 20 20:12:27 CET 2011 

Hi,

Fixes to both of your problems are now in the official hg repositories.
For more info, see
https://lemon.cs.elte.hu/trac/lemon/ticket/432
and
https://lemon.cs.elte.hu/trac/lemon/ticket/433

Regards,
Alpar


On Mon, 2011-12-19 at 18:38 +0100, Alpár Jüttner wrote:
> Hi,
> 
> 
> > However, the current package I have up on mentors uses the autotools
> > build system (of which I have some familiarity).  I'm now working on
> > switching that to use cmake (very little familiarity), so I have a bit
> > of learning to do.  One question I have so far - is there an
> > option/flag to build shared libraries using cmake, or would that
> > require changing/adding to the cmake 'configuration' files?
> 
> To be honest, shared LEMON library is of very little use. Most of the
> lemon codes are templates. The lib is really tiny, and only a handful of
> tools do actually need it (i.e: MIL/LP interface, command line argument
> parser, and color constants (for graphToEps())). So, static linking
> causes no real overhead. In addition, you will have less runtime
> dependency using static linking.
> 
> But, if you really want it, then it needs a single line change in
> lemon/CMakeLists.txt:
> 
> *********************************************
> diff --git a/lemon/CMakeLists.txt b/lemon/CMakeLists.txt
> --- a/lemon/CMakeLists.txt
> +++ b/lemon/CMakeLists.txt
> @@ -57,6 +57,7 @@
>  INSTALL(
>    TARGETS lemon
>    ARCHIVE DESTINATION lib
> +  LIBRARY DESTINATION lib
>    COMPONENT library
>  )
> *********************************************
> 
> (This could be added to the repo by default.)
> 
> Then, you can build shared library by:
> 
> cmake -DBUILD_SHARED_LIBS=yes ..
> 
> Regards,
> Alpar
> 
> 
> > 
> > Regards,
> > 
> > -Jeff
> > 
> > 
> > On Sat, Dec 17, 2011 at 4:41 PM, Alpár Jüttner <alpar at cs.elte.hu> wrote:
> > > Hi,
> > >
> > > Thank you for pointing out this issue. I've created a ticket about it,
> > > see https://lemon.cs.elte.hu/trac/lemon/ticket/432
> > >
> > >> It just appears to be a tarball packaging issue, is this something
> > >> that can be changed for future releases of LEMON?
> > >
> > > Certainly. I'll soon fix the related Makefile.am files in the
> > > development branch.
> > >
> > > Moreover, CMAKE will replace autotool as the default build environment
> > > starting from the upcoming major release. Thus, sooner or later all of
> > > these problems will disappear, because the release tarball will
> > > basically be a simple snapshot of the hg repository.
> > >
> > > Best regards,
> > > Alpar
> > >
> > > P.S.: I'm pleased to see your effort for providing Debian LEMON
> > > packages. Shouldn't we place a link to your packages here:
> > > https://lemon.cs.elte.hu/trac/lemon/wiki/Downloads
> > >
> > >
> > >
> > > On Fri, 2011-12-16 at 13:36 -0500, Jeffrey Wildman wrote:
> > >> 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 at lemon.cs.elte.hu
> > >> http://lemon.cs.elte.hu/mailman/listinfo/lemon-devel
> > >>
> > >
> > >
> > 
> 
> 
> _______________________________________________
> Lemon-devel mailing list
> Lemon-devel at lemon.cs.elte.hu
> http://lemon.cs.elte.hu/mailman/listinfo/lemon-devel

More information about the Lemon-devel mailing list