Subject: Re: [boost] [Range] Proposal: a sub-maintainer of Boost.Range
From: Michel Morin (mimomorin_at_[hidden])
Date: 2013-01-03 02:34:39
Nathan Ridge wrote:
> What is the purpose of having each of the following:
> 1. The code snippet containing an example of using the 'adjacent_filtered'
> range adaptor in libs/range/doc/reference/adaptors/adjacent_filtered.qbk
This code snippet should be replaced by the example file of 2.
This can be done using "import" directive:
Its qbk file (tools/quickbook/doc/block.qbk) and the imported cpp file
(stub.cpp) are an good example of how to use "import" directive.
> 2. libs/range/doc/reference/adaptors/examples/adjacent_filtered.cpp
> (seems to be the exact same as the code snippet).
> 3. libs/range/test/adaptor_test/adjacent_filtered_example.cpp
> (seems to be the exact same plus some Boost.Test stuff)
Hmm..., to remove this redundancy, I think we need to
add "code snippet markup" to the test file and import it into qbk doc
(and delete the example file):
Attached a sample of a marked-up cpp file. The code snippet can be
imported into adjacent_filtered.qbk by replacing `` ... `` with
You might want to ask what the best markup for this purpose is
at Boost.Documentation mailing list.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk