June 2007 - Boost - lists.boost.org

[Boost.Parameter] advice needed for Boost.svg_plot
by Jake Voytko 05 Jul '07

05 Jul '07

All, As you can see below, I've gone a long way on letting users customize plots. Link to code: http://svn.boost.org/trac/boost/wiki/soc/2007/VisualizationOfContainers#Com… Link to image: http://www.tcnj.edu/~voytko2/svg_complex.htm Mathias Gaunard suggested I look at "Boost.Parameter", and I think that it could provide a lot of benefits to my library. The question I have is how much should I let it influence my interface? There are functions that could clearly benefit from named parameters. plot_range() is the most obvious for me.. you could specify stroke and fill colors, shapes, etc along with the iterator information. There are also smaller gains that could be made, such as having a function for setting the styles of the legend, one for the plot ticks, one for the background, etc. What is the best practice for this? Should the use of named parameters be ubiquitous, or should I only use them where there are huge benefits? I want to make sure I stick with good practices before I start rewriting vast swaths of my headers. Thank you for your help, Jake

8 15

Re: [boost] [fusion][ping] how to initialize a container of non-const references to objects, from a container of objects
by dan marsden 05 Jul '07

05 Jul '07

Hi Sorry for the slow reply, I had to think a bit about which approach I preferred. Does the attached code, using transform_view do what you need? I'm not comfortable adding non const ctors to vector for a few reasons, so I'd prefer this approach if possible. Thanks Dan ___________________________________________________________ Yahoo! Answers - Got a question? Someone out there knows the answer. Try it now. http://uk.answers.yahoo.com/

3 3

[iostreams]Is this a bug?
by 邱宇舟 03 Jul '07

03 Jul '07

boost-1_34\boost\iostreams\copy.hpp line 80 - line 100 template<typename Source, typename Sink> std::streamsize copy_impl( Source& src, Sink& snk, std::streamsize buffer_size, mpl::false_, mpl::true_ ) { // Copy from an indirect Source to a direct Sink. using namespace std; typedef typename char_type_of<Source>::type char_type; typedef pair<char_type*, char_type*> pair_type; detail::basic_buffer<char_type> buf(buffer_size); pair_type p = snk.output_sequence(); streamsize total = 0; bool done = false; while (!done) { streamsize amt; done = (amt = iostreams::read(src, buf.data(), buffer_size)) == -1; std::copy(buf.data(), buf.data() + amt, p.first + total); if (amt != -1) total += amt; } return total; } When "iostreams::read" return -1 ,amt equal -1,it will assert in std::copy because iterator last < first. I use MSVC8.0 . It crashed only in DEBUG mode. I think it should be: while (!done) { streamsize amt; done = (amt = iostreams::read(src, buf.data(), buffer_size)) == -1; if (amt != -1){ std::copy(buf.data(), buf.data() + amt, p.first + total); total += amt; } }

4 3

Trac bugs - by assignee
by Marshall Clow 03 Jul '07

03 Jul '07

[ Back to the grind - there are currently 329 open bugs. Yowza! ] [ The people with the big counts are currently "None" and "Nobody" - can anyone help those guys out? ] 72 None 49 nobody 21 vladimir_prus 18 dgregor 16 jsiek 13 grafik 12 johnmaddock 11 turkanis 11 beman_dawes 10 az_sw_dude 7 speedsnail 7 samuel_k 7 david_abrahams 6 shammah 6 nesotto 6 jbandela 6 agurtovoy 5 rogeeff 4 urzuga 4 mark_rodgers 4 fcacciola 4 djowel 4 anthonyw 3 pdimov 3 jmaurer 3 ebf 3 dlwalker 2 witt 2 ramey 2 hubert_holin 2 alnsn 1 nmusatti 1 mistevens 1 mclow 1 kevlin 1 daniel_wallin 1 aaron_windsor None 1061 boost::filesystem::basic_recursive_directory_iterator fails on empty directories. None 1060 no example sources in online docs for Boost::Test None 1059 random_on_sphere can be made 10 times faster! None 1058 Cygwin libraries & GNU libtool None 1056 commentary typo fixes for wave; make jam compile None 1055 boost build system uses wrong `ar` for cross compilation. None 1051 MPL header ordering triggers bug None 1050 BOOST_CHECK_CLOSE_FRACTION documentation missing None 1049 Getting mpl/has_xxx.hpp to compile on AIX None 1047 Small Problem with the getting started guide making the whole build fail None 1045 [multi_array] Need a proper swap operation None 1042 Build: Incorrect parameters for IA64 architecture in MSVC toolset None 1038 "<" and ">" should be excaped in xml_oarchive None 1037 boost.serialization : invalid pointer dependant upon serialization order None 1036 assert failure in oserializer.hpp:418 None 1033 iostreams::restrict doesn't work on an iostreams::file_source None 1032 typo in Boost.Test documentation None 1027 [ptr_container] optional serialization support None 1023 inspect None 1022 Boost.Fusion at_c documentation in CVS HEAD references non-existing at_c.hpp (patch included) None 1021 [Graph][reverse_graph] Problem using reverse_graph adapter with an adapted user defined graph None 1020 Boost.Iterator proposal to add is_constant_iterator None 1019 iterator_facade::pointer should be the return type of operator-> (DR 445) None 1014 rename throws an exception that is not documented None 1006 No mingw.jam None 1004 [typeof] Support vc8 in native mode None 1003 [iostreams] copy-paste error in typedefs for wchar multichar_filters None 1002 [iostreams] close_impl<closable_tag> does not comply with spec None 997 error in boost::bind doc None 995 'multiply defined symbols' when including <boost/filesystem.hpp> in different source files None 991 [pool] None 987 configure passes wrong toolset to bjam None 982 x64 documentation for windows None 980 boost.format vc8/win32 compilation warning None 975 empty weak_ptr throws upon serialization None 974 spurious warning suppression code useful in shared_ptr.hpp None 969 basic_binary_iprimitive::load_binary bug None 968 xml_grammar - incorrect define char None 963 typeof: nested types of BOOST_TYPEOF'ed type don't work on gcc 3.4.5 in native mode None 962 Missing links in Test library documentation None 961 boost::basic_binary_oprimitive not instantiated correctly None 960 [random] lognormal_distribution problem None 956 Doc error in test examples. None 1041 Cygwin requires PATH setting. None 1030 execution_monitor.ipp #warning directive breaks compilation on MSVC 8.0 None 1011 amd64: #error Boost.Numeric.Interval: Please specify rounding control mechanism. None 1010 linking boost.python on freebsd None 1001 gcc 4.1.2 segfaults on mpl/test/apply.cpp None 999 prg_exec_fail3 fails on release variant None 998 prg_exec_fail2 fail on ppc None 907 gccxml compilation error under Windows None 853 path with spaces not always handled None 129 default build cleanup aaron_windsor 778 top-level configure is broken agurtovoy 861 [mpl] Detect nested template members with has_template_xxx agurtovoy 816 duplicat initial members -> erase_key postcond. fail agurtovoy 761 [mpl] evc4 port agurtovoy 640 documentation mistake agurtovoy 637 Adjusts mpl::pair concept to be compatible with STL pairs agurtovoy 588 mpl::remove compile error with gcc 4.1.0 alnsn 839 lexical_cast - local variable shadow patch alnsn 754 boost::any - typeid comparison across shared boundaries None 1053 Error using boost::mutex and C++/CLI anthonyw 881 errors when build with Apache stdcxx anthonyw 876 xtime documentation incomplete anthonyw 868 [thread] thread_specific_ptr::element_type ? anthonyw 802 [thread] MSVS: Allow use of thread headers with /Za None 1028 typo in boost header: date_time/time_defs.hpp az_sw_dude 890 date_time library supports only the current dst rule az_sw_dude 889 Insane Dependencies az_sw_dude 827 Unused variable in format date parser az_sw_dude 642 operator<< for gregorian::date_duration not found az_sw_dude 614 new timezone db file for #1471723 - 2007 DST support az_sw_dude 605 support new 2007 DST rules for timezone db az_sw_dude 604 from_ftime incorrectly processes FILETIME filled with zeros az_sw_dude 596 make timezone csv file C/C++ compatible az_sw_dude 316 date_time type conversion warning az_sw_dude 287 wrong usage of ios_base::narrow beman_dawes 897 exists() throws exeption on existing but locked file on wind beman_dawes 842 typo in auto_unit_test.hpp Revision 1.17 beman_dawes 824 BOOST_IOSTREAMS_HAS_LSEEK64 on Mac OS X beman_dawes 823 Seekable file_descriptor_source /sink? beman_dawes 752 directory_iterator doesn't work with catch beman_dawes 680 significantly different timer class behaviour on Win and Lin beman_dawes 662 [filesystem] portable_posix_name() may fail on premain call beman_dawes 607 Log level names wrong in documentation beman_dawes 600 VC8 can't find windows.h even though environment is correct! beman_dawes 559 linker error mingw 3.4.5 beman_dawes 222 Code analysis_ flaw detection_ debugging daniel_wallin 533 [Parameter] Docco error section 2.7.2 None 1064 problem on platforms with no errno.h header file None 1054 Parameter takes an "infinite" amount of time to compile with the Intel compiler. None 1044 Argument pack inaccessable in a functions return type david_abrahams 918 __doc__ strings david_abrahams 916 BPL Support for Python Callable Objects david_abrahams 910 gcc strict-aliasing problems with python david_abrahams 903 inconsistent usage of function pointer typedefs david_abrahams 865 Use of C++0x keyword as identifier david_abrahams 863 [parameter] fix operator|| for lazy binding david_abrahams 857 add shared_ptr< const T> support None 954 boost::dynamic_properties has no copy-constructor dgregor 891 Bunch of compilation error reported while using function.hpp dgregor 870 boost::graph::graph_utility.hpp is_connected() bad call dgregor 852 Problem with Boost and GCC 4.1 dgregor 829 Implicit graph not implement dgregor 738 Memory leaks with signal::connect? dgregor 736 Const correctness violation dgregor 735 Fruchterman-Reingold grid performance can be improved dgregor 733 Numbered headers don't work with "preferred" syntax dgregor 732 Johnson All-Pairs needs better "no path" information dgregor 708 Dijkstra no_init version should not require VertexListGraph dgregor 556 Bundled graph properties dgregor 447 reverse_graph and constness of property maps dgregor 403 Document copy_component dgregor 402 random_vertex/random_edge are unnecessarily inefficient dgregor 395 BGL graph types do not support allocators dgregor 375 LEDA graph adaptors do not handle hidden nodes properly dgregor 373 LEDA graph adaptors for undirected graphs dgregor 372 adjacency_matrix should model BidirectionalGraph djowel 664 crash in boost::spirit::parse djowel 543 Embedded python won't compile djowel 314 spirit insert_key_actor.hpp djowel 241 Miss " = ParserT()" dlwalker 766 "Bug" in comment (x2) dlwalker 653 [integer] add support for integers longer than long dlwalker 613 boost/crc.hpp uses non-standard conforming syntax ebf 993 Variant should use least common multiple of alignments_ rather than maximum ebf 965 [doc] boost::variant tutorial - final example uses v1_v2 should be seq1_seq2 ebf 547 [variant] Compile time checked getter fcacciola 818 No zero-argument in_place() fcacciola 765 optional documentation fcacciola 617 Numeric Conversion Documentation minor bug fcacciola 282 boost::optional<enum> fails with /CLR None 1040 boost.devel archive at ActiveState disconnected None 1031 AmigaOS fixes for bjam None 989 Boost build does not support building universal binaries on macintosh None 121 toolset initialization None 94 Better reporting of failed expectation. None 93 Testing problems on AIX and OSF grafik 1062 Cygwin install stage fails with combination of patches grafik 977 bjam crashes when compiled with gcc 4.2 grafik 959 linking fails when Boost is compiled with STLport 5.1.* on Linux (names mismatch) grafik 896 <native-wchar_t>off does not work when build with vc-8.0 grafik 798 bjam: always define OSPLAT grafik 721 Generated files "@()" don't work in regular expressions. grafik 683 libraries won't build grafik 616 Boost Jam_ and non english directorys grafik 552 Building universal binary on MacOSX grafik 546 boost.build needs fixes for HP/UX grafik 497 Unable to build boost with Dinkumware STL version 4.02 grafik 481 Linker Problems with VC .NET 2003 / STLPort / Boost grafik 431 boost jam problem with parallel builds hubert_holin 647 octonion documentation bug hubert_holin 162 Cannot compile octonion_test.cpp because of bug in sinc.hpp jbandela 665 bug in char_separator jbandela 501 token_iterator::at_end() result is inversed jbandela 306 Visual C++ "Language Extensions" support jbandela 283 Compiler error for tokenizer on Solaris jbandela 279 SLOOOWW tokenizer compilation on VC++6.0 jbandela 259 Problem compiling :/ jmaurer 920 Proposed extension to random library jmaurer 819 uniform_int<> with type's maximum availaible range error jmaurer 351 Diff in state of mersenne_twister gen between GCC3.41 & CW9 None 1008 Undocumented type traits. johnmaddock 883 errors when build with Apache stdcxx johnmaddock 812 Crash on RH machine with gcc < 3.4 johnmaddock 775 Warnings on MSVC 2005 johnmaddock 764 [regex] add support for a BOOST_NO_CREGEX mode johnmaddock 679 regex - perl syntax affects what gets matched johnmaddock 633 [config] evc4 port johnmaddock 591 make portable stdint.h from boost code johnmaddock 540 Please add support for Borland C++ Builder 2006 johnmaddock 502 Problem running configure for unsupported platform johnmaddock 492 Adding boost::is_complex to type_traits.hpp johnmaddock 360 Regex johnmaddock 315 Implement operator[] for Tokenizer jsiek 900 graphml reader namespace handling is broken jsiek 875 No iterator based constructor for adjacency_matrix jsiek 815 remove_edge core dumps on self-circle jsiek 813 concept_check.hpp unused variable warning jsiek 694 Add Maximum Common Subgraph (MCS) algorithm jsiek 693 Add clique detection algorithms DFMax_ Bron-Kerbosch jsiek 636 strange compiling problem for transitive_closure jsiek 580 Max Flow Algorithm jsiek 575 Calling subgraph::global_to_local on a root graph jsiek 541 [concept_check.hpp] remove unused variable warning in msvc jsiek 416 Spelling of Edmonds-Karp-Algorithm jsiek 193 Check ordering for mutexes jsiek 182 Support aspect-orientation jsiek 116 creating my own properties jsiek 100 more use of the concept "allocator" jsiek 69 Boost with Dinkumware C++ Library !? kevlin 913 Specialization of lexical_cast mark_rodgers 821 allow_unregistered improvement mark_rodgers 558 add database library? mark_rodgers 87 function to get the size of a array mark_rodgers 30 parser mclow 75 Solaris - once.cpp compile error mistevens 688 ublas: bug in mapped_vector_of_mapped_vector nesotto 807 boost::assignment documentation: mathematical "typo" nesotto 730 The ptr_map iterator cannot be dereference to value type nesotto 723 local_time_facet error in VS2005 Win2003 nesotto 624 bug in boost::range_detail nesotto 518 [Boost.Range]boost::const_begin calls non-qualified 'begin' nesotto 471 boost.range and "const char[]". nmusatti 285 Borland compiler error with Pool_ boost::pool_allocator nobody 930 iostream and zlib nobody 924 Convenience function for const map read nobody 922 Lexical cast and wide characters nobody 911 [bind] inline placeholder macro nobody 908 gccxml compilation bug under Windows nobody 905 Assertion failed in token_iterator.hpp nobody 902 patch for Visual Studio 8 + Windows x64 (AMD64) nobody 894 mutli_array/types.hpp 64-bit types? nobody 884 [iostreams] workaround for the boost + stdcxx on MSVC 7.1 nobody 879 Building Boost with Apache C++ Standard Library (STDCXX) nobody 874 Ability to partially specialize implementation_level nobody 871 Problem build boost 1.33.1 on Aix 4.3.3 nobody 862 [utility] Make result_of handle lambda expressions nobody 851 xml handling library nobody 825 PocketPC 2003/2005 MSVS8 nobody 800 [filesystem] chdir() nobody 799 mpl::if_ nobody 796 [ublas] vector::back() nobody 795 [ublas] vector::back() nobody 790 MSVC 8 & STLport nobody 746 max flow with lower bounds (capacities) nobody 714 [jam] HardLink rule on NT platform nobody 687 [program_options] Allow unrecognized options in configfile nobody 659 provide an abstract "Task" type based on Boost.Threads nobody 621 filesystem::path as a template nobody 590 mkstemp nobody 530 Boost.Ruby nobody 513 darwin 64 bit support nobody 494 STLPort with NO_IOSTREAMS nobody 428 Please add support for PDSK compilers for x64 and IA64 nobody 418 Please add support for Intel 9 WIN32 nobody 366 handle double '/' in the boost::filesystem nobody 313 lock-free data structures nobody 310 Stand-alone ternary state tree nobody 296 Associative containers that search on keys or values nobody 294 unicode support in boost::filesystem nobody 224 Extensions to std::string: compareIgnoreCase()_ trim()_ ... nobody 221 Overall tree structure of boost. nobody 187 locale nobody 123 target templates nobody 122 stage rule nobody 112 'distclean' target nobody 105 Why noncopyable destructor isn't virtual nobody 98 Better notion of link-compatibility nobody 96 Finish target paths nobody 64 Documentation nobody 55 Generator Relevance Filtering nobody 26 mem_iter - iterator to object member nobody 17 Socket wrapper class pdimov 810 support for weak_ptr binding pdimov 445 Can't delete automatically in circularly included object. pdimov 398 Support for embedded VC++ 4.0 ramey 878 error C2039: 'mbstate_t' : is not a member of 'std' ramey 877 'NULL' undefined in basic_serializer_map.cpp rogeeff 893 grammatical error in error message rogeeff 847 [Test Library] How to init/free a singleton rogeeff 762 [test] evc4 issue with SEH support rogeeff 747 failing on 6 targets in MacOS X rogeeff 645 [test] no eh exception handling functions on evc4 samuel_k 859 boost::format ignores a user defined locale samuel_k 849 boost::format and operator priority rule samuel_k 713 Boost.Format doesn't work on MSVC with /vd2 compiler option samuel_k 704 format zero length string msvc-8 samuel_k 585 64 bit compile warning/error for boost::format samuel_k 570 boost::format parse method doesn't work samuel_k 493 format: assert when parsing invalid pattern shammah 840 pool allocator - local variable shadow patch shammah 836 warning using pool.hpp shammah 386 boost::pool_allocator breaks with vector of vectors shammah 290 perfomance: memory cleanup for pool takes too long shammah 284 pool::purge_memory() does not reset next_size shammah 88 ct_gcd_lcm.hpp compilation error speedsnail 615 thread identification and getting the id speedsnail 204 Add a monitor class speedsnail 194 Exchange results between several thread calls speedsnail 174 cooperation with ACE framework speedsnail 173 more synchronization primitives for the threads classes speedsnail 172 cooperation with ZThread package speedsnail 171 class for function calls that are not thread safe turkanis 869 [iostreams] patch for building by BBv2 turkanis 856 iostreams file_descriptor::write fails under Win32 turkanis 822 Incorrect usage of bad_write()_ bad_seek() etc. turkanis 817 Performance problem in iostreams turkanis 791 iostreams::tee_filter is for output only turkanis 786 bug in iostreams/copy.hpp line 81 turkanis 699 Changing size of memory-mapped file on Windows turkanis 586 iostreams // file_descriptor::seek BUG on files > 4 GB turkanis 579 boost.iostreams file_descriptor and sharing turkanis 525 problem with boost::iostreams when compiled with Visual C++ turkanis 484 Boost.Iostreams and newline translation urzuga 864 [lambda][utility] Make lambda support result<> urzuga 781 Lambda: (_1 + "y")(string("x")) Doesn't Compile urzuga 574 [boost::lambda] Compile error with libstdc++ debug mode urzuga 426 lambda vs pure virtual functions None 985 can't use bjam to disable specific VC warning None 984 using 'define=XYZ' as bjam command line argument doesn't work None 981 [program_options] config file parser format documentation vladimir_prus 898 [program_options] improper guess vladimir_prus 887 Duplicate target name bug on Cygwin vladimir_prus 850 program_options strips off escaped quotes in some situations vladimir_prus 808 [program_options] parse_config_file documentation bug vladimir_prus 773 program_options find assert fails with multibyte characters vladimir_prus 756 VC80-Compatible String Processing in format_paragraph() vladimir_prus 749 Function name error in program_options documentation vladimir_prus 748 Parameter reversal in program_options documentation vladimir_prus 739 [program_options] putenv on Solaris vladimir_prus 691 Bjam build should support attachment of individual build ids vladimir_prus 689 [program_options] Endless loop with long default arguments vladimir_prus 674 find-library for boost decorated names vladimir_prus 646 [program_options] static const variable on evc4 vladimir_prus 644 Boost.Build v2 build script help for evc4 vladimir_prus 627 program_options: format_paragraph assert fails on long line vladimir_prus 469 multitoken broken in program_options 1.33 vladimir_prus 348 program_options bug? vladimir_prus 342 program_options Can one have options with optional values? vladimir_prus 341 program_options Can one have options with optional values? vladimir_prus 120 toolset flags vladimir_prus 119 Dependency & exported properties None 1046 Boost.Python quickstart instructions mention nonexistent target None 973 zip_iterator has value_type == reference None 957 The "Getting Started" page does not mention the stdlib option witt 834 Homepage regression links witt 145 filter iterator adaptor should be able to be bidirectional -- -- Marshall Marshall Clow Idio Software <mailto:marshall@idio.com> It is by caffeine alone I set my mind in motion. It is by the beans of Java that thoughts acquire speed, the hands acquire shaking, the shaking becomes a warning. It is by caffeine alone I set my mind in motion.

5 9

Progress of Boost.SVG_Plot
by Jake Voytko 03 Jul '07

03 Jul '07

For those who have put time or energy into making suggestions for the SVG_Plot program, an update (with pretty pictures!) is on the wiki: http://svn.boost.org/trac/boost/wiki/soc/2007/VisualizationOfContainers Feedback / use cases welcome ;). So far it only produces graphs in one dimension, but inch by inch it's getting better! Hopefully by the halfway point, I'll have a working legend system as well as graphs in two dimensions, and I hope to take a good chunk out of the list of suggestions that I've been given! Further into the future, I want to look at the animation / hover features that SVG has to offer to see if I can take advantage of them for data display purposes and make the output of the program awesome. Jake

12 31

[Boost-bugs] [ boost-Support Requests-1707948 ] Assertion failed in token_iterator.hpp
by SourceForge.net 03 Jul '07

03 Jul '07

Support Requests item #1707948, was opened at 2007-04-26 03:08 Message generated for change (Tracker Item Submitted) made by Item Submitter You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=207586&aid=1707948&group_… Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: None Group: None Status: Open Resolution: None Priority: 5 Private: No Submitted By: Nobody/Anonymous (nobody) Assigned to: Nobody/Anonymous (nobody) Summary: Assertion failed in token_iterator.hpp Initial Comment: Using BOOST.1.33.1 with Borland C++. I've suddenly got a Message Box saying: Assertion failed: valid_, file ...boost/token_iterator.hpp, line 52 Line 52 in token_iterator.hpp is: assert(valid_); in void increment(){}. Could anybody give me a clue as to what might be going on and why it has suddenly started happening, please? With thanks in anticipation, Paul Collins (paul(a)screen.subtitling.com) ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=207586&aid=1707948&group_… ------------------------------------------------------------------------- This SF.net email is sponsored by DB2 Express Download DB2 Express C - the FREE version of DB2 express and take control of your XML. No limits. Just data. Click to get it now. http://sourceforge.net/powerbar/db2/ _______________________________________________ Boost-bugs mailing list Boost-bugs(a)lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/boost-bugs

2 1

Boost documentation
by Gennadiy Rozental 03 Jul '07

03 Jul '07

Hi, I've been offline for a bit. But I was able to spend several weeks learning DocBook. I must say I was really impressed with quality of this project. I also tried to get a grasp of BoostBook and gave perfunctory look on quickbook. Here I would like to share my thoughts on recent "doc update" movement. I. quickbook as documentation media. Why, oh, why don't we learn from our own mistakes. We just started to realize the problem we got ourselves into with makesystem. And immediately find new toy to play with. However fun it is, however cool it might look on first sight, THIS IS NOT OUR BUSENESS to invent/support documentation format. DocBook is very mature, well supported project. It's based on widely accepted/supported technologies. It's powerful and configurable to implement essentially anything one need. I personally don't see much valid reasons to look in home grown format direction. Here some specific points: 1. Simplicity Some people argues that it's easier to type quickbook I might argue that it's actually opposite. Granted if you use vi XML editing is not fun. But myriads of modern XML editors simplify the process marginally. There several WYSWYG editors producing DocBook (and I don't need to enter markup at all!) and this trend is going to grow. In addition you get immediate format validation and presentation (using assigned stylesheets) 2. Any change in DocBook have to be reflected in quickbook terms 3. Someone need to maintain quickbook parser/transformer 4. quickbook will never be as flexible as DocBook 5. This is new *nonstandard* format any new developer will have to learn. I don't believe we can afford yet another barrier for new submitters. 6. Source code highlighting My understanding is that quickbook presents some source code highlighting automation. IMO this can be either implemented as standalone C++ based tool that docs writers can use when required or even better it can be implemented in JavaScript. I believe I've seen it done. All in all I believe using this format is going to be a maintenance problem in a long term and should be avoided. We should stick with industry standard DocBook IMO instead. II. BoostBook 1. Complexity The BoostBook being an extension to DocBook seems to be doing too much. IMO any useful generic innovations should be proposed to the DocBook developers and eventually removed. All in all we should strive to make this layer as thin as possible. 2. Test suites support. I did not really grasp the idea behind this feature completely, but from what I understand this is "misfeature" and should be removed 3. Tight coupling with Boost.Build This is major problem I believe. Especially in documentation. BoostBook should be presented as independent project. It should be explained how to use it, configure it without any reference to Boost.Build at all. At the very last chapter of documentation we may refer that if you want you docs to be automatically generated on some remote host (if let's say you don't have all the tools set up locally for all the formats) this is what you need to do ..... 4. Documentation I found documentation to be largely unacceptable (funny thing for the project dedicated to writing documentation) a) No explanation how to use BoostBook without Boost.Build (see above) b) all he elements description are without examples c) most critical: no description whatsoever of all the modification done in comparison with DocBook. All the updated parameter need to be listed, all the updated templates need to be explained. General approach should be what the person familiar with DocBook (standard) need to know/expect to use BoostBook d) No explanation on how to extend the BoostBook (especially in comparison with DocBook) As I mentioned before we should try to limit our extensions to the most necessary only and strive to stick with standard DocBook. Also all extensions should be made optional. III. What should we do? IMO the standardization efforts need to target DocBook/BoostBook. On the other hand each developer should be allowed to extend/twick standard L&F. Usually differences should be only cosmetic. Following are general observations about common L&F 1. JS Menu support. I believe it should be implemented but made optional. I personally don't like it (I believe it's just wait of space for this menu to stay on all the time) and prefer "location path" kinda navigation Boost.Test currently using. 2. Header on top. I don't believe it's necessary. Neither in a form of boost|libraries|more|... nor what is currently proposed. This information is accessible from boost main page. No need to duplicate it on every page of every library. 3. Frames I personally need frames support for the reference like pages (like in preprocessor and test libraries). I am open to the alternative that presents similar L&F. 4. Portability This is major requirement for all the features we implement. They should work on at least set of predefined "major" browsers. Please make this as discouraging comments to overall documentation efforts movements. I just don't believe we move in right direction. Regards, Gennadiy

20 97

clarification about limits.hpp
by Ulrich Eckhardt 02 Jul '07

02 Jul '07

Hi! This is basically the result of a discussion on the STLport mailinglist. The question came up what this code means: #if defined(_BIG_ENDIAN) 0x7f80 << (sizeof(int)*CHAR_BIT-16), #else 0x7f800000, #endif This is from detail/limits.hpp. The puzzling thing is that the result for big-endian targets is exactly the same, unless the size of an int is not 32 bit, but the size of the int has nothing to do with endianess still... I dug around a bit, and it was added some time ago by John Maddock with the comment that it adds support for big-endian SPARC machines, but later also used for big-endian MIPS and PPC. There also used to be a comment saying something like: "making this depend on big-endian targets is wrong, it's the layout of floats we care about, not the layout of integers when written to memory". This comment was removed when the ad-hoc endian detection was replaced with the centralized one. Can anybody see what this code is supposed to do? I understand that 0x7f800000 is an integer with the same bit layout as one of the special floating point constants, but I can't figure out why it would be any different on big-endian machines. Uli

2 2

[math toolkit]
by Leopoldo Peralta 02 Jul '07

02 Jul '07

This Fatal Error occurs when trying to compile a MSVC 2003 (SP1) project using the proposed Math Toolkit: C:\boost_1_34_0_beta\boost_1_34_0\boost\math\special_functions\log1p.hpp(195 ): error C2785: 'tools::promote_args<T>::type boost::math::log1p(T)' and 'double boost::math::log1p(double)' have different return types Any fix to this error? Leopoldo Peralta

2 8

Authors of libraries with html based docs, please read
by Matias Capeletto 02 Jul '07

02 Jul '07

Hi! We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work. The only thing you will have to do is to edit .qbk files instead of .html files the next time you have to change your docs. Believe me when I say that it is very very easy to learn (ask anyone about this), your docs will be more maintainable and documenting will start to be a fun part of your boost work. After the translation we offer our time to help you learning Quickbook. We have two volunteers (Jake and Glyn) that are eagerly waiting for a first victim :) They are sending private email to authors but it will be nice to have a TODO list of docs to convert. Please tell us if we can help you. Thanks for helping us improve boost documentation Best Regards Matias

9 18