quickbook crash, for bjam docs.

Rene Rivera — 2008-11-24T04:48:49

I was attempting to generate the docs for bjam, in preparation for doing a bjam release, and found myself looking at a MSVC JIT debug dialog. I don't have time to investigate further until mush later in the week. But I thought I'd point the problem out in case someone feels generous enough to look into the problem ;-)

Use BoostBook standalone?

Rutger Hofman — 2008-10-29T23:49:01

Good evening list, my project (.c and .h, basically no c++) requires documentation in DocBook. In the past, I have been a contented user of doxygen. BoostBook has the capacity to generate DocBook .sgml from doxygen-annotated code, is that correct? My question: can I use BoostBook to generate DocBook .sgml from my doxygen-annotated header files without using Boost itself? If so, how? I have been trying to find my way in the Boost distro, but I didn't yet fathom its intricacies. Thanks, Rutger Hofman VU Amsterdam

tools/boostbook/xsl/docbook.xsl issue

vicente.botet — 2008-11-18T22:02:04

_______________________________________________ Boost-docs mailing list Boost-docs< at >lists.boost.org http://lists.boost.org/mailman/listinfo.cgi/boost-docs

configure and Makefile where?

Adem — 2008-10-13T03:53:04

The online documentation at http://www.boost.org/doc/libs/1_36_0/more/getting_started/unix-variants.html#link-your-program-to-a-boost-library says under section 5.1 "Easy Build and Install" that there is a configure and Makefile file, but in the svn trunk these files are missing. I wanted to use the filesystem library but it brings errors like "undefined reference to `boost::system::get_system_category()'" etc. How can I apply what is written in section 5.1 of the boost manual?

Doc build failure... For bjam.

Rene Rivera — 2008-10-10T02:41:51

So had some time tonight to read some emails... And The problem I'm having with building the bjam docs has nothing to do with what Beman has been ahving problems with. When I try and build the bjam docs, note I build them in standalone mode, I get the following: ==== xslt-xsltproc ..\..\..\bin.v2\tools\jam\doc\msvc-9.0xp\dbg\lnk-sttc\thrd-mlt\bjam.docbook ../../../bin.v2/tools/jam/doc/msvc-9.0xp/dbg/lnk-sttc/thrd-mlt/bjam.xml:2: warning: failed to load external entity "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd" BoostBook XML V1.0//EN" "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd" ^ ../../../bin.v2/tools/jam/doc/msvc-9.0xp/dbg/lnk-sttc/thrd-mlt/bjam.xml:839: parser error : Entity 'nbsp' not defined -d n -d +n -d 0 ^ ../../../bin.v2/tools/jam/doc/msvc-9.0xp/dbg/lnk-sttc/thrd-mlt/bjam.xml:883: parser error : Entity 'nbsp' not defined -f Jambase -j n -l n -o file -s var -t target -- value

[1.37] Release Notes

Daniel James — 2008-10-09T22:34:32

Hello everyone, The template for the 1.37.0 release notes are at: http://svn.boost.org/svn/boost/website/public_html/beta/feed/history/boost_1_37_0.qbk Please can you add the relevant details for your libraries. Or if you prefer, just reply with the details and I'll add them for you. If you wish to bring up anything else, please do it in a new thread because it'll make life easier. thanks for your help, Daniel

Doc build failure on release branch

Beman Dawes — 2008-10-08T11:47:57

The daily release snapshot is working again. See http://boost.cowic.de/rc/ The doc build seems to be working, except that there is one quickbook failure: assertion "streams.empty()" failed: file "e:\boost-release\windows\tools\quickbook\detail\collector.cpp", line 46 "../bin.v2/tools/quickbook/gcc-3.4.4/debug/link-static/quickbook.exe" -I".." --output-file="../bin.v2/libs/asio/doc/gcc-3.4.4/debug/asio_doc.xml" "../libs/asio/doc/asio.qbk" ...failed quickbook.quickbook-to-boostbook ../bin.v2/libs/asio/doc/gcc-3.4.4/debug/asio_doc.xml... ...removing ../bin.v2/libs/asio/doc/gcc-3.4.4/debug/asio_doc.xml We need a fix for this so it doesn't delay the 1.37.0 beta. Thanks, --Beman

Libraries by category

Joel de Guzman — 2008-09-30T05:11:20

Hi, I'm lost. How do you get the libraries by category from the main page? E.g. http://www.boost.org/doc/libs/1_36_0/libs/libraries.htm#Category Regards,

generating boost-book with setup_boostbook.sh

mess-mate — 2008-09-26T15:41:32

Hi, i try to generate the boostbook with (for linux) setup_boostbook.sh. I've this error: Could not find a Jamfile in directory boost_1_36_0/tools/regression/build/regression/build. But there is no tools/regression/build/regression/build !! Only a 'tools/regression/build' ?? BR

[quickbook] Moving documentation into combineddocumentation

Daniel James — 2008-09-16T21:59:45

Hello again, For some time the quickbook documentation has been part of the combined documentation in trunk, but all the links are broken as they're relative to the standalone directory, which is why this hasn't been released. I had planned to create a mechanism for absolute links (from boost root) but it doesn't look like I'm going to get that done anytime soon, so instead I want to just update the links so that they're relative to combined documentation, and delete the standalone documentation. This means that if you build the standalone documentation then several links will be broken. If no one objects, I'll do this soon. By the way, if you think I should be posting these things as trac tickets, say something and I'll do that in the future. I'm never sure which root to go. Daniel

[boostbook] Generate filenames which conform better tothe guidelines

Daniel James — 2008-09-16T20:28:01

Hello all, I've attached a patch which I wrote a while ago. It changes the way ids are generated so that some the transformations done when translating the id to file and directory names are now done when generating the ids. This can deal with the symbols in filenames better and truncate directory and file names which are longer than the limits suggested by the boost guidelines. A possible downside is that the same transformation are also applied to the ids. I actually think this is a good thing, as we shouldn't be using some of these symbols in ids - especially dots which can be confused for separators, and it keeps the ids a little shorter. Ids do get used in URLs (in the fragment part), so they should be quite conservative. If there's no objections I'll commit the patch (or something very similar) soon. I want to test it and review it myself first, as I wrote it some time ago. Daniel

Generating HTML files from BoostBook XML files

Boris — 2008-09-15T08:20:00

I went through the hassle of setting up the toolchain for BoostBook manually and managed to get it to work (on Cygwin). Now I can run bjam in boost/libs/foo/doc which processes my BoostBook documents and creates HTML files in the subdirectory html. As index.html refers to ./boostbook.css I understand that all HTML files need to be copied to boost/doc/html (at least I found boostbook.css there)? Is this something which is done by bjam automatically? If it is I guess I need to run bjam not in my doc directory but in BOOST_ROOT (and pass some arguments for bjam to understand only to build the documentation in boost/libs/foo/doc)? I assume that if I run bjam from BOOST_ROOT I won't get any warnings anymore either that referenced libraries are not found (like "warning: Cannot find library 'Asio'" as I've used Boost.Asio somewhere)? In my BoostBook documents I also refer to a PNG file (with ). While the img tag is generated in the HTML file the PNG file is not copied to the subdirectory html. Is there any support in bjam for referenced files like images or they need to be copied manually? Boris

Request on Boost documentation for translate to Russian

karfagen — 2008-09-09T00:01:21

Hello everyone! So, as far as I know the Boost library is very famous library and more and more programmers are used it in own projects (in particular in Russia, I know). Almost preffereable in the developers world libraries are have localized documentation. I suggest to discuss this issues with Boost community: for example, how make the translation of the Boost documentation to Russian language. I would like to organize this process but I don't know how make it technically: on the Boost main domain site, or other site an etc. Does anyone to help me for this issues? For example, I coulde be translate the original docs page by page but where could I publish it? Where could I report about translated library's pages? An so on on the same wave... Does exists the srvice as I mentioned above? Best regards, Serebryakoff Alexey ------------------------------ Russian Federation 630091, Novosibirsk Phone: +7 (383) 2 173 873 Cellular: + 7 923 126 66 35 Emails: agent_cia< at >mail.ru overlapped< at >gmail.com overlapped< at >hotmail.com ICQ: 22442032 Skype: overlapped MSN: overlapped< at >hotmail.com _____ avast! Antivirus : Ishodjashaja soobshenie chistoje. Virusnaja baza dannih (VPS): 080908-0, 08.09.2008 Provereno: 09.09.2008 6:09:34 avast! - (c) 1988-2008 ALWIL Software. _____ avast! Antivirus : Ishodjashaja soobshenie chistoje. Virusnaja baza dannih (VPS): 080908-0, 08.09.2008 Provereno: 09.09.2008 7:01:21 avast! - (c) 1988-2008 ALWIL Software.

[Boost.Test] Dead Link

Ruediger Berlich — 2008-09-02T21:21:22

Hi there, here are two more dead links, this time in the Boost.Test tutorials. On page http://www.boost.org/doc/libs/1_36_0/libs/test/doc/html/tutorials/new-year-resolution.html the two links "listing1" and "listing2" point nowhere. Best Regards, Ruediger

QuickBook comments

Daryle Walker — 2008-08-21T23:11:25

These are based on a trial of building and using Quickbook through the Xcode IDE (2.5 on a Mac OS X 10.4.11 PowerPC system). It build OK after I added targets for libraries Boost.FileSystem (which needed Boost.System) and Boost.ProgramOptions. Running the tool without any command line parameters or input yields an error message and doesn't offer how to get help. Looking at the main quickbook.cpp file showed me that the --help option works, and that's how I got how to run files through. Maybe the no input error message can be improved as to indicate where the help is.

Quick script for quickbook builds?

Daryle Walker — 2008-08-19T20:34:02

Is there a quick script out there I can stick in my XCode (2.5, still on Mac OS X 10.4) project file, under a run-script phase, that can convert a *.qbk file to an HTML file? In other words, I want to "compile" any QuickBook files so I can check my progress without a big trip to the command line and messing around with bjam.

[boost/limits.hpp] Dead link

Ruediger Berlich — 2008-08-15T16:16:26

Hi there, boost/limits.hpp refers at the top of the file to documentation available from http://www.boost.org/libs/utility/limits.html . That link points nowhere, and indeed boost.limits doesn't seem to be documented in the utility library. Best, Ruediger /*************************************************************************/ The Steinbuch Centre for Computing of Karlsruhe Institute of Technology (the Cooperation of Forschungszentrum Karlsruhe GmbH and Universitaet Karlsruhe TH) will run its annual GridKa School from September 8th to 12th, 2008. Please find further information at http://www.fzk.de/gks08 . /*************************************************************************/ Forschungszentrum Karlsruhe GmbH Sitz: Weberstraße 5 76133 Karlsruhe Amtsgericht Mannheim HRB 100302 Vorsitzende des Aufsichtsrats: Baerbel Brumme-Bothe Vors. der Geschäftsführung: Prof. Dr. Eberhard Umbach _______________________________________________ Boost-docs mailing list Boost-docs< at >lists.boost.org http://lists.boost.org/mailman/listinfo.cgi/boost-docs

Dead links in boost serialization

Rafal — 2008-08-10T17:38:03

http://www.boost.org/doc/libs/1_35_0/libs/serialization/doc/tutorial.html#pointers 1) http://www.boost.org/doc/libs/1_35_0/libs/serialization/example/demo_xml.cpp works, but I dont see any way to get the needed .hpp file? 2) missing http://www.boost.org/doc/libs/1_35_0/libs/serialization/example/demo_save.xml probably others there. How do I get the complete source of bus example? This is really a problem for most examples.

Dead link in documentation

Ruediger Berlich — 2008-08-05T17:33:37

Hi there, just a short note to say that, at the end of http://www.boost.org/doc/libs/1_35_0/libs/conversion/cast.htm , the link in "An old numeric_cast that was contributed by Kevlin Henney is now superseeded by the Boost Numeric Conversion Library" points into nowhere. http://www.boost.org/doc/libs/1_35_0/libs/numeric/conversion/doc/index.html results in 404 Not Found File "boost_1_35_0/libs/numeric/conversion/doc/index.html" not found. Best, Ruediger

gmane.comp.lib.boost.documentation

Making Boost Doc builds more robust

Boostbook DTD clash