- Boost - lists.boost.org

Documentation and directory structure
by Robert Ramey 04 Nov '08

04 Nov '08

I've just downloaded the 1.37 release. I have the svn tree, but I wanted the pre-built documentation. I was very disappointed that I found the documentation in different places depending on how it was generated. So for some libraries its in ../doc/html and for others its in libs/<library_name>/doc. This is really confusing. It also suggests that the documentation build is some humungous script which builds all the documentation at once. I realise that boost likes to do things like this way - but never the less its very inconvenient for those of us who just want to use a small portion of boost in any given project. Can't we rationalize the documentation build in to something like the following? a) directory structure .../libs/<library_name>/doc Jamfile.v2 (optional) html .... docbook ... quickbook ... whatever. b) ability to build documentation for one library at a time by invoking bjam or whatever Advantages a) consistent directory structure b) release could but would necessarily have to include the prebuilt documentation c) easier for developers to fiddle with documentation of one library at a time d) easier to extract one library from boost e) easier to understand and use the documentation build process Robert Ramey

2 1

CMake build system is Merged into Trunk
by Michael Jackson 04 Nov '08

04 Nov '08

With the encouragement of Doug Gregor and the support of other Boost moderators I have merged the work from the CMake branch into trunk. The CMake branch was a branch to develop a new build system for boost based on the opensource CMake build system (www.cmake.org) The current state of the build system is unstable and still has work to be done. Compiling of the static libraries on at least one system (OS X 10.5.5 Intel) was completed and the installation of the libraries and headers was performed. There is still much work to be done but we are hoping to quickly improve the state of the cmake build system so that it becomes usable. NOTHING has been done to compromise the current build system based on BJam. For more information on getting started with CMake and boost please take a look at this page: <https://svn.boost.org/trac/boost/wiki/CMake> I will be adding to the CMake documentation on the wiki as soon as I can. For those familiar with CMake here is the 2 second how to (For Unix/ line command): Install CMake 2.6.2 from www.cmake.org Update your Boost trunk. Open boost/CMakeLists.txt and comment out the following line: message(FATAL_ERROR "") Create a build directory for boost (I suggest 'Build' within the boost directory) cd into Build cmake ../ .. Let that go for a little while make modularize .. Let that go for a while. This WILL change the layout of the boost working directory so WATCH OUT for this. Once this is complete there is NO 'undo' so the only way to get your working directory back the way it was is to do a revert from svn. Once this runs the bjam system WILL break. So ONLY do this if you want to either work on the CMake system or try it out. And finally run make Windows Users: Run the 'cmake-gui.exe' app and point it to your working directory. Tell the app where to put its build files (Binary directory) and hit configure. Pick what type of build files you want generated, and then let it "configure" After it is done configuring click the "Generate" button. Your project files, makefiles, or Visual Studio files should now be created. Testing is NOT complete as of yet. I am still getting all the cmake files updated. If you have comments, feedback or anything else either file a bug in the trac system or come join us on the boost-cmake mailing list <http://lists.boost.org/mailman/listinfo.cgi/boost-cmake > Again, I would like to stress that NOTHING has been done to change the current bjam based build system. If it DID break let me know ASAP and I will fix it. Thanks _________________________________________________________ Mike Jackson mike.jackson(a)bluequartz.net BlueQuartz Software www.bluequartz.net Principal Software Engineer Dayton, Ohio

3 3

Serialization - basic_text_iprimitive destructor throws
by John Salmon 04 Nov '08

04 Nov '08

I tried turning on exceptions on the input stream that I use for a text_iarchive, hoping to catch user-level errors such as an attempt to treat a non-archive file as an archive. It seems that when exceptions are enabled on the underlying stream, the basic_text_iprimitive destructor throws a second(?) basic_ios::failure exception, during stack unwinding, which lands me unhappily in the terminate handler. Can the basic_text_iprimitive destructor be protected against accidentally throwing? Here's an demonstration. This is on a Linux system with gcc/4.1.2. John Salmon salmonj(a)drdblogin6.en.desres$ cat ser.cpp #include <boost/archive/text_iarchive.hpp> #include <boost/serialization/serialization.hpp> #include <stdexcept> #include <fstream> struct Foo{ int i, j; private: friend class boost::serialization::access; template <class Archive> void serialize(Archive & ar, const unsigned int version) { ar & i & j; } }; int main(){ Foo foo; std::ifstream ifs("/dev/null"); ifs.exceptions(std::istream::failbit | std::istream::badbit); try{ boost::archive::text_iarchive tia(ifs); tia >> foo; }catch(std::ios_base::failure &e){ std::cerr << "Caught std::ios_base::failure. What: " << e.what() << "\n"; }catch(std::exception &e){ std::cerr << "Caught exception. What: " << e.what() << "\n"; } return 0; } salmonj(a)drdblogin6.en.desres$ xmk g++ -I/proj/desres/root/Linux/x86_64/boost/1_37_0-13/Release/include -g -L/proj/desres/root/Linux/x86_64/boost/1_37_0-13/Release/lib -Wl,-rpath,/proj/desres/root/Linux/x86_64/boost/1_37_0-13/Release/lib ser.cpp -lboost_serialization -o ser salmonj(a)drdblogin6.en.desres$ ser terminate called after throwing an instance of 'std::ios_base::failure' what(): basic_ios::clear Aborted (core dumped) salmonj(a)drdblogin6.en.desres$ gdb -c drdblogin6.en.desres.deshaw.com-6718.core ser GNU gdb 6.8 Copyright (C) 2008 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. Type "show copying" and "show warranty" for details. This GDB was configured as "x86_64-unknown-linux-gnu"... Reading symbols from /proj/desrad-c/root/Linux/x86_64/boost/1_37_0-13/Release/lib/libboost_serialization.so...done. Loaded symbols for /proj/desres/root/Linux/x86_64/boost/1_37_0-13/Release/lib/libboost_serialization.so Reading symbols from /proj/desrad-c/root/Linux/x86_64/gcc/4.1.2-10/lib64/libstdc++.so.6...done. Loaded symbols for /proj/desres/root/Linux/x86_64/gcc/4.1.2-10/lib64/libstdc++.so.6 Reading symbols from /lib64/tls/libm.so.6...done. Loaded symbols for /lib64/tls/libm.so.6 Reading symbols from /proj/desrad-c/root/Linux/x86_64/gcc/4.1.2-10/lib64/libgcc_s.so.1...done. Loaded symbols for /proj/desres/root/Linux/x86_64/gcc/4.1.2-10/lib64/libgcc_s.so.1 Reading symbols from /lib64/tls/libc.so.6...done. Loaded symbols for /lib64/tls/libc.so.6 Reading symbols from /lib64/ld-linux-x86-64.so.2...done. Loaded symbols for /lib64/ld-linux-x86-64.so.2 Core was generated by `ser'. Program terminated with signal 6, Aborted. [New process 6718] #0 0x0000003f72a2e25d in raise () from /lib64/tls/libc.so.6 (gdb) where #0 0x0000003f72a2e25d in raise () from /lib64/tls/libc.so.6 #1 0x0000003f72a2fa5e in abort () from /lib64/tls/libc.so.6 #2 0x00002b5ab82f5f84 in __gnu_cxx::__verbose_terminate_handler () at /state/partition1/tmp/tmpXcQw4O/gcc-4.1.2-10/gcc-4.1.2/libstdc++-v3/libsupc++/vterminate.cc:97 #3 0x00002b5ab82f4106 in __cxxabiv1::__terminate (handler=0x1a3e) at /state/partition1/tmp/tmpXcQw4O/gcc-4.1.2-10/gcc-4.1.2/libstdc++-v3/libsupc++/eh_terminate.cc:43 #4 0x00002b5ab82f350b in __cxa_call_terminate (ue_header=0x50b730) at /state/partition1/tmp/tmpXcQw4O/gcc-4.1.2-10/gcc-4.1.2/libstdc++-v3/libsupc++/eh_call.cc:60 #5 0x00002b5ab82f3fa7 in __gxx_personality_v0 ( version=<value optimized out>, actions=6, exception_class=<value optimized out>, ue_header=0x50b730, context=0x7ffff29e5610) at /state/partition1/tmp/tmpXcQw4O/gcc-4.1.2-10/gcc-4.1.2/libstdc++-v3/libsupc++/eh_personality.cc:637 #6 0x00002b5ab846a068 in _Unwind_RaiseException_Phase2 (exc=0x50b730, context=0x7ffff29e5610) at /state/partition1/tmp/tmpXcQw4O/gcc-4.1.2-10/gcc-4.1.2/gcc/unwind.inc:66 #7 0x00002b5ab846a2db in _Unwind_Resume (exc=0x50b730) at /state/partition1/tmp/tmpXcQw4O/gcc-4.1.2-10/gcc-4.1.2/gcc/unwind.inc:234 #8 0x00002b5ab80fd790 in boost::archive::basic_text_iprimitive<std::istream>::~basic_text_iprimitive () from /proj/desres/root/Linux/x86_64/boost/1_37_0-13/Release/lib/libboost_serialization.so #9 0x00002b5ab8109e0c in boost::archive::text_iarchive_impl<boost::archive::text_iarchive>::text_iarchive_impl () from /proj/desres/root/Linux/x86_64/boost/1_37_0-13/Release/lib/libboost_serialization.so #10 0x00000000004045ab in text_iarchive (this=0x7ffff29e5ae0, is=@0x7ffff29e58d0, flags=0) at /proj/desres/root/Linux/x86_64/boost/1_37_0-13/Release/include/boost/archive/text_iarchive.hpp:110 #11 0x0000000000402c84 in main () at ser.cpp:24 (gdb) quit salmonj(a)drdblogin6.en.desres$

1 0

boost::integer library request
by Jorge Lodos Vigil 04 Nov '08

04 Nov '08

Hi Is there any chance the code below could be added to the integer library? More specifically, to the integer_mask.hpp header? If there is, I would be happy to provide tests and documentation. We use it to get significant parts of unsigned integer values, it is a superset of LOBYTE, HIBYTE, LOWORD and HIWORD windows macros and generates no binary code in optimized compilations. Thanks in advance. template < std::size_t Bits, typename Unsigned > inline typename uint_t<Bits>::least lobits(Unsigned n) { n &= low_bits_mask_t<Bits>::sig_bits; return (uint_t<Bits>::least)n; } template < std::size_t Bits, typename Unsigned > inline typename uint_t<Bits>::least hibits(Unsigned n) { n >>= (std::numeric_limits<Unsigned>::digits - low_bits_mask_t<Bits>::bit_count); return (uint_t<Bits>::least)n; } template <typename Unsigned> inline uint8_t lobyte(Unsigned n) { return lobits<8, Unsigned>(n); } template <typename Unsigned> inline uint8_t hibyte(Unsigned n) { return hibits<8, Unsigned>(n); } template <typename Unsigned> inline uint16_t loword16(Unsigned n) { return lobits<16, Unsigned>(n); } template <typename Unsigned> inline uint16_t hiword16(Unsigned n) { return hibits<16, Unsigned>(n); } template <typename Unsigned> inline uint32_t loword32(Unsigned n) { return lobits<32, Unsigned>(n); } template <typename Unsigned> inline uint32_t hiword32(Unsigned n) { return hibits<32, Unsigned>(n); } Best regards Jorge

1 0

[threadpool] new version v12
by k-oli＠gmx.de 04 Nov '08

04 Nov '08

Hello, the new version of Boost.Threadpool depends on Boost.Fiber. regards, Oliver

10 54

Default build
by Vladimir Prus 04 Nov '08

04 Nov '08

Hi, I'd like to have a small poll: 1. Do you use the 'default build' project attribute. 2. Can you tell what properties are set there? 3. Do you use that to specify multiple property sets? Thanks, Volodya P.S. Anybody who uses default build and fails to reply may get their projects broken without warning :-)

3 2

[BGL] got stuck at "error_type_must_be_a_signed_integer_type" error
by Sandeep Gupta 04 Nov '08

04 Nov '08

Hi, Not sure how much interest is in leda wrapper of BGL. But the new version of leda broke the leda wrapper. I have made some quick fixes. However i got stuck at this error: boost_1_36_0/boost/concept_check.hpp:91: error: request for member 'error_type_must_be_a_signed_integer_type' in '((boost::SignedInteger<leda::edge_struct* const*>*)this)->boost::SignedInteger<leda::edge_struct* const*>::x', which is of non-class type 'leda::edge_struct* const*' Hopefully its the last one. After this technically the wrapper should compile. I have briefly tested it with connecte components routines. If there is interest i will happy to post the changes.. thanks sandeep

1 0

Yet another shot at reflection/introspection
by Jean-Louis Leroy 04 Nov '08

04 Nov '08

I have committed a new library to the sandbox. It's called "introspection". It's another shot at implementing reflection. I am aware that similar work already exists, like Jeremy Pack's reflection library and Boost.Mirror (although this one currently supports only compile-time reflection). It's a work in progress - the testsuite is the doc at this point ;-) - and maybe it will never be completed/submitted. My primary goal is not to implement reflection per se, I'd be happy to leave the honor to Jeremy but currently it's not clear that his work can serve as a basis for my future developments (multimethods, generic object manipulation). Jean-Louis

1 0

[1.37.0][date-time] Breaking the log jam
by Beman Dawes 04 Nov '08

04 Nov '08

Andrey Semashev has pulled together a number of patches to address backed-up date-time tickets. He has tested them on Linux and Windows. The arrangement was that Jeff Garland would look them over, but Jeff just isn't finding the time to do that. I've taken a look at a few of the proposed fixes. Without knowing anything about date-time, these seem like problems that really should have been fixed some time ago.The proposed patches I looked at seemed fine. So I think it is important we break the log jam. Proposal: * We give Andrey write permission. * He starts moving these fixes into trunk right away. * Anyone who cares about data-time watch the commits carefully, and discuss any issues with Andrey. * Once Andrey is satisfied with trunk test results, he asks permission to merge to release. * Unless there has been undue delay or issues have come up, we will give permission for this release. * I'm willing to hold the release a few days; in aggregate this is an important set of overdue fixes to a major library so I'd like to see them go in this release. Comments? --Beman

7 15

Boost 1.37.0 Release Notice
by Beman Dawes 03 Nov '08

03 Nov '08

Boost 1.37.0 has been released and is available from SourceForge. See http://sourceforge.net/projects/boost/ This release includes one new library: Proto: Expression template library and compiler construction toolkit for domain-specific embedded languages, from Eric Niebler. Updated libraries include Asio, Circular Buffer, Dynamic Bitset, Hash, Interprocess, Intrusive, Math Type, Traits, and Unordered. The release managers were Beman Dawes, Daniel James, Eric Niebler, and Rene Rivera. The web site should be updated soon to reflect the new release. If you can't wait, see http://beta.boost.org now! --Beman Dawes

6 5