Hey, I'm hooked on quickbook. I'm wondering what people think of taking the scoping out of include_action::operator() in actions.cpp, or providing some way to turn it off.
The use case is this. My docs have become very big, building them takes prohibitively long, and so I've broken them up into several chapters, one-per-file. There is a toplevel doc (book) that xincludes the docbook generated by each chapter. I use lots of little macros that look like this: [def *something [link something /something/]] So that at the most-important-point-of-documenation for "something", i put a [#something] [section The docs for something] ... and then wherever I'm typing along, I can always just say "For more info see *something". And "something" is produced, italicized and linked. I can change the appearance of those links in one place, and [#something] is easy to search for when I need to change the definition. I'm finding this *very* helpful with keeping information from getting fragmented. I have my macros in a header file macros.qbk, and [include] them in each chapter (and you can generate an index from them). Another problem this addresses is with [link]: doing [link to.the_autogenerated_name.of.the.section link text] can get untypably long, and if you later rearrange the structure of your docs, all the links break. Thoughts? Thanks for a cool tool... -t ------------------------------------------------------- SF.Net email is sponsored by: Tame your development challenges with Apache's Geronimo App Server. Download it for free - -and be entered to win a 42" plasma tv or your very own Sony(tm)PSP. Click here to play: http://sourceforge.net/geronimo.php _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
