Ion Gazta�aga wrote:
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!
Sure! It's a royal pain! Lucky for us, help is on its way. Rene Rivera
just wrote an installer for windows. If you use windows, then you can
use the isnatller now. Rewind back a bit, see his post "[tools] Here's
the installer..".
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?
Just grab the CSS from quickbook's docs and place it in your docs.
It's as simple as that :)
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?
It's automatic, depending on which type of document you are writing.
I noticed that it's dependent on the Qbk header info. What type of doc
are you generating?
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?
Ok, I have no experience with this. Maybe others might be more
helpful here. Eric?
Thanks for the answers and keep on working in QuickBook, it is really
nice. Regards,
Oh thanks! There's only one way but up. Qbk will only get better :-)
And... thanks to you and all early adopters! We have a nice TODO
list that I'm so eager to implement.
Regards,
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
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
