Hello to all,
I've just finished porting my Shmem library documentation from BoostBook to Quickbook. I'm pretty satisfied with Quickbook, it's easy, nice and fast, congratulations!
As an small critique, I would say the it hasn't been easy to build quickbook, because I downloaded a whole boost cvs snapshot, tried to build it with bjam --v2, but a lot of problems appeared. After several hours wasted , I rebuilt bjam, configured bjam v2 settings, reconfigured BoostBook, and I even needed to fix a program_options header to compile it. I also got a lot of unresolved references and I had to create an static release version of program_options and quickbook. Well, I suppose it was a bug in the snapshot (or a bug in my head), but it was _really_ hard to set up all this Bjam.V2/DocBook/BoostBook/QuickBook stuff. Sorry for the comment but I needed to say it!
Document porting from BoostBook to QuickBook was very easy. QuickBook syntax is really easy and handy. Syntax highlighting in [c++] sections is also nice. If anyone wants to help me, I have some very basic questions regarding QuickBook:
1) The default build gives me the same style as the old BookBook. I've seen Boost.QuickBook's, Boost.Thread's and other Boost libraries' style is more modern and eye-candy. I don't have any idea about XML/CSS/stylesheet stuff. What do I need to do in my configuration to get more polished style documentation?
2) I've seen unordered associative container documentation is using QuickBook and has a TOC in the beginning. I don't see that TOC in the .qbk file. What do I need to do to get it?
3) This is a very basic questions but, if I execute bjam --v2 in my library's doc folder, all generated htmls go to a doc/html folder. But doxygen links to header files and boost icons are not shown because usually boost libraries build their help files in a higher level boost/doc directory. How can I do that?
Thanks for the answers and keep on working in QuickBook, it is really nice. Regards,
Ion
------------------------------------------------------- This SF.Net email is sponsored by: NEC IT Guy Games. Get your fingers limbered up and give it your best shot. 4 great events, 4 opportunities to win big! Highest score wins.NEC IT Guy Games. Play to win an NEC 61 plasma display. Visit http://www.necitguy.com/?r=20 _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
