James Fowler wrote:
I've put a snapshot of my latest twisted up version of QuickBook at
http://www.openseaconsulting.com/boost/qb20050306.zip. This is NOT what
I would consider anywhere close to thoroughly tested, although it is
working for me so far with MSVC7.1. There are a number of things in
there that have been recently discussed, as well as a few tidbits I
threw in while working on documentation for one of my current projects.
Here's a quick overview of what's in there:
This is awesome! Some comments below...
* Thomas's dynamic highlighting code
o I fixed the newline problem
o still a bit flaky with tabs
We need a program options flag for this which defaults
to 4 spaces. Thoughts?
o quickbook.hlt automatically loaded at startup
* [sectionlink ...]
* [macroref ...]
What's macroref? I seem to have missed this?
* include support
Cool!
o [include ...] directive
+ does the obvious thing for somefile.qbk
Nice!
+ loads somefile.hlt as syntax highlight definition
(untested)
Don't you think we ought to just standardize on a quickbook
inline syntax for this?
+ anything else is considered source code, so [include
../example/simple_example.cpp] does the "right thing"
> + common source code extensions [py/h/hpp/c/cpp/...]
> will automatically pre-select the right source mode
> for highlighting
I think we ought to have the extensions in the syntax definition.
For example:
"cpp" { extensions = "cpp"|"hpp"|.... }
o -I / --include_path command line option to add additional
directories for file search
Are we using boost::file_system now?
o directory search order
+ current directory
+ directories specified on command line
+ $(BOOST_ROOT)/tools/quickbook, if BOOST_ROOT is set in
environment vars
+ quickbook executable directory, if it can be found
o default.qbk / user.qbk are NOT automatically loaded (yet...)
+ only thing loaded automatically is quickbook.hlt
* [table .notitile ...] and [variablelist .notitle ...] allow tables
without requiring a title
Nice!
* all this is documented in quickbook.qbk
Cheers and Nice work!
--
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net
-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
