[Boost-docs] Quickbook wish list..

Subject: [Boost-docs] Quickbook wish list..
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2011-11-22 16:18:42

While doing the documentation for the Predef library I'm working on I've
run into a set of features that seems either inconsistent or just missing.
I thought it would be good to share the list for future reference and
general feedback:

* Ability to apply syntax coloring to code blocks one at a time. Right now
one can globally switch the language system with "[c++]" etc. But what I'd
rather have is the capability to to a temporary switch (i.e. a push and
pop). In my case I want to set the global default to "teletype" and then
choose "c++" for certain places.

* Ability to use code callouts in regular code blocks instead of just in
code "import". This seems like just a consistency issue. It seems to me
that the code markup aspect available to the "import" should be available
to code blocks also. Although right now callouts are the only feature in
this context.

* And of course I've already mentioned the file inclusion/extraction from
code files.

* And the related include/import with file globs. (I'm actually working on
translating the glob implementation from b2/bjam to work in quickbook since
Daniel prefers globs. And b2 has a really small and standalone
implementation of globs.)

Rene.

-- 
-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo