[quickbook] probs with docu generation (C++ code)
Hello, I've a porblem with document generation with quickbook. The code in the *.qbk files get some strange extra characters appended (in the example belwo: 'e seco'). Could please so kind to help? regards, Oliver threadpool.qbk boost::tp::pool< boost::tp::unbounded_channel< boost::tp::fifo > > pool( boost::tp::poolsize( 6), boost::posix_time::posix_time::milliseconds( 50), boost::tp::scanns(10) ); generates in the output: boost::tp::pool< boost::tp::unbounded_channel< boost::tp::fifo > > pool( boost::tp::poolsize( 6), boost::posix_time::posix_time::milliseconds( 50), boost::tp::scanns(10) ); e seco ^^^^^^^ why are this chars inserted quickbook xml output: <programlisting> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">tp</phrase><phrase role="special">::</phrase><phrase role="identifier">pool</phrase><phrase role="special"><</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">tp</phrase><phrase role="special">::</phrase><phrase role="identifier">unbounded_channel</phrase><phrase role="special"><</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">tp</phrase><phrase role="special">::</phrase><phrase role="identifier">fifo</phrase> <phrase role="special">></phrase> <phrase role="special">></phrase> <phrase role="identifier">pool</phrase><phrase role="special">(</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">tp</phrase><phrase role="special">::</phrase><phrase role="identifier">poolsize</phrase><phrase role="special">(</phrase> <phrase role="number">6</phrase><phrase role="special">),</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">posix_time</phrase><phrase role="special">::</phrase><phrase role="identifier">milliseconds</phrase><phrase role="special">(</phrase> <phrase role="number">50</phrase><phrase role="special">),</phrase> <phrase role="identifier">boost</phrase><phrase role="special">::</phrase><phrase role="identifier">tp</phrase><phrase role="special">::</phrase><phrase role="identifier">scanns</phrase><phrase role="special">(</phrase><phrase role="number">10</phrase><phrase role="special">)</phrase> <phrase role="special">);</phrase> <phrase role="identifier">e</phrase> <phrase role="identifier">seco</phrase></programlisting> -- GMX Download-Spiele: Preizsturz! Alle Puzzle-Spiele Deluxe über 60% billiger. http://games.entertainment.gmx.net/de/entertainment/games/download/puzzle/in...
Oliver Kowalke wrote:
Hello, I've a porblem with document generation with quickbook. The code in the *.qbk files get some strange extra characters appended (in the example belwo: 'e seco'). Could please so kind to help?
regards, Oliver
threadpool.qbk
boost::tp::pool< boost::tp::unbounded_channel< boost::tp::fifo > > pool( boost::tp::poolsize( 6), boost::posix_time::posix_time::milliseconds( 50), boost::tp::scanns(10) );
generates in the output:
boost::tp::pool< boost::tp::unbounded_channel< boost::tp::fifo > > pool( boost::tp::poolsize( 6), boost::posix_time::posix_time::milliseconds( 50), boost::tp::scanns(10) ); e seco
^^^^^^^ why are this chars inserted
Could you post a minimal test qbk file that exhibits the problem? Regards, -- Joel de Guzman http://www.boostpro.com http://spirit.sf.net
Hello, I've appended two qbk-files (test.qbk, code. qbk). ############################ is inserted by quickbook. regards, Oliver
Oliver Kowalke wrote:
Hello, I've a porblem with document generation with quickbook. The code in the *.qbk files get some strange extra characters appended (in the example belwo: 'e seco'). Could please so kind to help?
regards, Oliver
threadpool.qbk
boost::tp::pool< boost::tp::unbounded_channel< boost::tp::fifo > > pool( boost::tp::poolsize( 6), boost::posix_time::posix_time::milliseconds( 50), boost::tp::scanns(10) );
generates in the output:
boost::tp::pool< boost::tp::unbounded_channel< boost::tp::fifo > > pool( boost::tp::poolsize( 6), boost::posix_time::posix_time::milliseconds( 50), boost::tp::scanns(10) ); e seco
^^^^^^^ why are this chars inserted
Could you post a minimal test qbk file that exhibits the problem?
Regards, -- Joel de Guzman http://www.boostpro.com http://spirit.sf.net
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
-- "Feel free" - 10 GB Mailbox, 100 FreeSMS/Monat ... Jetzt GMX TopMail testen: http://www.gmx.net/de/go/topmail
Oliver Kowalke wrote:
Hello,
I've appended two qbk-files (test.qbk, code. qbk).
############################
is inserted by quickbook.
Odd. I can't reprocude it :( Works fine here. Regards, -- Joel de Guzman http://www.boostpro.com http://spirit.sf.net
Hmm - I tried to generate the docu for Boost:thread -> same result: additional chars added to the code. I've tested it on two LINUX (Debian/Lenny) systems. Maybe my ~/user-config.jam is wrong? using xsltproc ; using boostbook : /usr/share/xml/docbook/stylesheet/nwalsh : /usr/share/xml/docbook/schema/dtd/4.2 ; using doxygen ; using quickbook : /usr/local/bin/quickbook ; regards, Oliver
Oliver Kowalke wrote:
Hello,
I've appended two qbk-files (test.qbk, code. qbk).
############################
is inserted by quickbook.
Odd. I can't reprocude it :( Works fine here.
Regards, -- Joel de Guzman http://www.boostpro.com http://spirit.sf.net
_______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
-- "Feel free" - 5 GB Mailbox, 50 FreeSMS/Monat ... Jetzt GMX ProMail testen: http://www.gmx.net/de/go/promail
Oliver Kowalke wrote:
Hello, I've a porblem with document generation with quickbook. The code in the *.qbk files get some strange extra characters appended (in the example belwo: 'e seco'). Could please so kind to help?
I've seen that before if the quickbook files have \r\n line endings, but are processed by a *nix version of quickbook that expects \n endings (for example if you use cygwin on win 32). Could that be the case here? HTH, John.
2008/10/27 John Maddock <john@johnmaddock.co.uk>:
I've seen that before if the quickbook files have \r\n line endings, but are processed by a *nix version of quickbook that expects \n endings (for example if you use cygwin on win 32). Could that be the case here?
Probably. This should be fixed in trunk and the new release. In case you're interested, there's an iterator created using an iterator adpator that converts windows newlines to single character newlines. But it was incorrectly tagged as a random access iterator - so std::string's constructor uses 'operator-' and gets the length of the original string (with '\r\n's) but then fills it with the newlines converted to single (so the string is shorter) leaving some junk characters at the end. Daniel
In case you're interested, there's an iterator created using an iterator adpator that converts windows newlines to single character newlines. But it was incorrectly tagged as a random access iterator - so std::string's constructor uses 'operator-' and gets the length of the original string (with '\r\n's) but then fills it with the newlines converted to single (so the string is shorter) leaving some junk characters at the end.
I got a copy from trunk - now it works. thx! Oliver -- Psssst! Schon vom neuen GMX MultiMessenger gehört? Der kann`s mit allen: http://www.gmx.net/de/go/multimessenger
On Mon, Oct 27, 2008 at 10:27:20AM +0000, Daniel James wrote:
2008/10/27 John Maddock <john@johnmaddock.co.uk>:
I've seen that before if the quickbook files have \r\n line endings, but are processed by a *nix version of quickbook that expects \n endings (for example if you use cygwin on win 32). Could that be the case here?
Probably. This should be fixed in trunk and the new release.
I checked the release branch for missing or bogus svn:eol-style properties and found a few. I was very surprised not to find hundreds or even more such files. Here is a list. I also attached the output of svn diff but you probably cannot apply a patch on properties. Please check and commit: M boost/compatibility/cpp_c_headers/csignal M boost/compatibility/cpp_c_headers/cstdlib M boost/compatibility/cpp_c_headers/cstdio M boost/compatibility/cpp_c_headers/cstdarg M boost/compatibility/cpp_c_headers/cctype M boost/compatibility/cpp_c_headers/cerrno M boost/compatibility/cpp_c_headers/cmath M boost/compatibility/cpp_c_headers/ctime M boost/compatibility/cpp_c_headers/clocale M boost/compatibility/cpp_c_headers/climits M boost/compatibility/cpp_c_headers/cassert M boost/compatibility/cpp_c_headers/csetjmp M boost/compatibility/cpp_c_headers/cwchar M boost/compatibility/cpp_c_headers/cfloat M boost/compatibility/cpp_c_headers/cstring M boost/compatibility/cpp_c_headers/cstddef M boost/compatibility/cpp_c_headers/cwctype M boost/tr1/tr1/algorithm M boost/tr1/tr1/array M libs/intrusive/proj/vc7ide/sg_set/sg_set.vcproj M libs/intrusive/proj/vc7ide/avl_set/avl_set.vcproj M libs/intrusive/proj/vc7ide/sg_multiset/sg_multiset.vcproj M libs/intrusive/proj/vc7ide/splay_set/splay_set.vcproj M libs/intrusive/proj/vc7ide/avl_multiset/avl_multiset.vcproj M libs/intrusive/proj/vc7ide/splay_multiset/splay_multiset.vcproj M libs/mpl/doc/src/refmanual/refmanual.toc M libs/multi_array/test/regression.cfg M libs/date_time/test/local_time/poorly_formed_zonespec.csv M libs/date_time/test/local_time/README.poorly_formed_zonespec M libs/date_time/data/README.zone_spec_csv_file M libs/date_time/data/date_time_zonespec.csv M libs/logic/doc/tribool.boostbook M libs/graph/test/regression.cfg M libs/graph/LICENSE M libs/graph/doc/figs/seq_vertex_coloring.graffle M libs/graph/doc/figs/biconnected.dot M libs/graph/doc/transitive_closure.w M libs/graph/doc/awpaper.sty M libs/graph/doc/isomorphism-impl-v2.w M libs/graph/doc/minimum_degree_ordering.w M libs/graph/doc/lgrind.sty M libs/graph/doc/mungeaux.csh M libs/graph/doc/math.sty M libs/graph/doc/isomorphism-impl-v3.w M libs/graph/doc/iso-eg.dot M libs/graph/doc/biconnected_components.w M libs/graph/doc/isomorphism-impl.w M libs/graph/doc/strong_components.w M libs/graph/example/figs/telephone-network.dot M libs/graph/example/figs/cc-internet.dot M libs/graph/example/figs/edge-connectivity.dot M libs/graph/example/figs/dfs-example.dot M libs/graph/example/figs/ospf-graph.dot M libs/graph/example/figs/scc.dot M libs/graph/example/tc.dot M libs/graph/example/scc.dot M libs/graph/example/graphviz_test.dot M libs/graph/example/regression.cfg M libs/graph/example/leda-regression.cfg M libs/graph/example/test-astar-cities.dot M libs/graph/example/sgb-regression.cfg M libs/graph/example/graphviz_example.dot M libs/statechart/test/InconsistentHistoryTest1.vcproj M libs/statechart/test/DeferralTest.vcproj M libs/statechart/test/InconsistentHistoryTest5.vcproj M libs/statechart/test/TerminationTest.vcproj M libs/statechart/test/InvalidChartTest3.vcproj M libs/statechart/test/UnsuppDeepHistoryTest.vcproj M libs/statechart/test/UnconsumedResultTest.vcproj M libs/statechart/test/InvalidResultCopyTest.vcproj M libs/statechart/test/InvalidTransitionTest2.vcproj M libs/statechart/test/InconsistentHistoryTest4.vcproj M libs/statechart/test/InvalidResultAssignTest.vcproj M libs/statechart/test/InconsistentHistoryTest8.vcproj M libs/statechart/test/InvalidChartTest2.vcproj M libs/statechart/test/StateCastTest.vcproj M libs/statechart/test/InvalidResultDefCtorTest.vcproj M libs/statechart/test/InvalidTransitionTest1.vcproj M libs/statechart/test/InconsistentHistoryTest3.vcproj M libs/statechart/test/TuTest.vcproj M libs/statechart/test/InvalidChartTest1.vcproj M libs/statechart/test/InconsistentHistoryTest7.vcproj M libs/statechart/test/TransitionTest.vcproj M libs/statechart/test/StateIterationTest.vcproj M libs/statechart/test/FifoSchedulerTest.vcproj M libs/statechart/test/InconsistentHistoryTest2.vcproj M libs/statechart/test/InconsistentHistoryTest6.vcproj M libs/statechart/test/InStateReactionTest.vcproj M libs/statechart/test/TypeInfoTest.vcproj M libs/statechart/test/CustomReactionTest.vcproj M libs/statechart/test/HistoryTest.vcproj M libs/statechart/example/Keyboard/Keyboard.vcproj M libs/statechart/example/Performance/Performance.vcproj M libs/statechart/example/BitMachine/BitMachine.vcproj M libs/statechart/example/Handcrafted/Handcrafted.vcproj M libs/statechart/example/Camera/Camera.vcproj M libs/statechart/example/StopWatch/StopWatch.vcproj M libs/statechart/Statechart.sln M libs/utility/sublibs M libs/thread/test/util.inl M libs/thread/test/Carbon.r M libs/xpressive/example/example.vcproj M libs/iterator/doc/GNUmakefile M libs/iterator/doc/docutils.sty M libs/iterator/doc/rst2html M libs/iterator/doc/rst2latex M libs/functional/sublibs M libs/interprocess/proj/vc7ide/managed_shared_memory.vcproj M libs/interprocess/proj/vc7ide/offset_ptr_test.vcproj M libs/interprocess/proj/vc7ide/doc_managed_grow.vcproj M libs/lambda/test/README_gcc2.9x_users M libs/function/test/regression.cfg M libs/optional/doc/html/HTML.manifest M libs/algorithm/sublibs M libs/bimap/doc/bimap.hdf M libs/wave/src/cpplexer/re2clex/strict_cpp.re M libs/wave/src/cpplexer/re2clex/cpp.re M tools/regression/build/vcide/process_jam_log.sln M tools/regression/build/vcide/process_jam_log.vcproj M tools/regression/test/test-cases/incremental/bjam.log.1 M tools/regression/test/test-cases/incremental/bjam.log M tools/regression/test/test-cases/Huber2629/bjam.log M tools/boostbook/setup_boostbook.sh M tools/jam/src/debian/control M tools/jam/src/debian/jam.man.sgml M tools/jam/src/debian/changelog M tools/jam/src/debian/copyright M tools/jam/src/debian/rules M tools/jam/src/jamgram.yy M tools/jam/src/Jambase M tools/jam/src/boost-jam.spec M tools/jam/src/jamgram.y M tools/jam/src/build_vms.com M tools/quickbook/test/code-snippet.quickbook M tools/quickbook/test/preformatted.gold M tools/quickbook/test/templates.gold M tools/quickbook/test/preformatted.quickbook M tools/quickbook/test/templates.quickbook M tools/quickbook/test/code-block-1.gold M tools/quickbook/test/escape.gold M tools/quickbook/test/code-block-2.gold M tools/quickbook/test/code-block-1.quickbook M tools/quickbook/test/escape.quickbook M tools/quickbook/test/quickbook-manual.gold M tools/quickbook/test/code-block-2.quickbook M tools/quickbook/test/quickbook-manual.quickbook M tools/quickbook/test/link-side-by-side.gold M tools/quickbook/test/import.gold M tools/quickbook/test/link-side-by-side.quickbook M tools/quickbook/test/xinclude.gold M tools/quickbook/test/import.quickbook M tools/quickbook/test/xinclude.quickbook M tools/quickbook/test/code-snippet.gold Currently 231 *.vcproj files have eol-style set to native and only 9 to CRLF. Many have this property not set. Setting it to "native" should be OK. PS: There are also again many files with bogus svn:executable flag. It does not make sense that a HTML file is marked executable! That's just wrong.
On Mon, Oct 27, 2008 at 10:27:20AM +0000, Daniel James wrote:
Probably. This should be fixed in trunk and the new release.
Just to be clear, the following isn't really related to the quickbook bug that I fixed. 2008/10/27 Jens Seidel <jensseidel@users.sf.net>:
I checked the release branch for missing or bogus svn:eol-style properties and found a few. I was very surprised not to find hundreds or even more such files.
Here is a list. I also attached the output of svn diff but you probably cannot apply a patch on properties. Please check and commit:
Thanks for checking this, I think that most of the files you indicated were fixed in trunk four months (revision 46445) but it was never merged. Beman, is it okay to merge this? It's not vital, but it shouldn't break anything. Although, I'm a little weary about changing Jamfiles, as they seem to be to sensitive to line endings. I think the only case which is important are the shell scripts, which must have unix line-endings.
Currently 231 *.vcproj files have eol-style set to native and only 9 to CRLF. Many have this property not set. Setting it to "native" should be OK.
This isn't really worth fixing in the release, but I'll look into fixing it in trunk, and updating the subversion instructions on the wiki. Daniel
On Mon, Oct 27, 2008 at 2:22 PM, Daniel James <daniel_james@fmail.co.uk>wrote:
On Mon, Oct 27, 2008 at 10:27:20AM +0000, Daniel James wrote:
Probably. This should be fixed in trunk and the new release.
Just to be clear, the following isn't really related to the quickbook bug that I fixed.
2008/10/27 Jens Seidel <jensseidel@users.sf.net>:
I checked the release branch for missing or bogus svn:eol-style
properties
and found a few. I was very surprised not to find hundreds or even more such files.
Here is a list. I also attached the output of svn diff but you probably cannot apply a patch on properties. Please check and commit:
Thanks for checking this, I think that most of the files you indicated were fixed in trunk four months (revision 46445) but it was never merged. Beman, is it okay to merge this? It's not vital, but it shouldn't break anything. Although, I'm a little weary about changing Jamfiles, as they seem to be to sensitive to line endings. I think the only case which is important are the shell scripts, which must have unix line-endings.
Hum... I'm a little concerned about changing at this point. I'm leaning toward waiting until after the release, at least for the Jamfiles. --Beman
participants (6)
-
Beman Dawes -
Daniel James -
Jens Seidel -
Joel de Guzman -
John Maddock -
Oliver Kowalke