Boost logo

Boost :

Subject: Re: [boost] [test] Looking for co-developer/maintainer
From: Richard (legalize+jeeves_at_[hidden])
Date: 2014-05-19 18:46:46

[Please do not mail me a copy of your followup]

boost_at_[hidden] spake the secret code
<loom.20140124T171012-251_at_[hidden]> thusly:

>These are not implementation details at all. The fact that you are not using
>them does not make them useless. There are some people (admetedly less then
>those who are suing UTF) who need these to be documented.

Specifics, please.

Again the general statement is made without specifics.

>For example? Which undocumented macros?

It's difficult to list them one by one because the existing
documentation has no suitable index that clearly lists all the symbols
that it explains.

>Richards, version has some number of pages with Richards view on how one
>should be testing things, but these are just views for the most part. We
>might want to keep something like this in "suggestions" sections.

It's in the user guide. You make this statement as if what I wrote
was somehow "just my opinion", when in fact it is the common practice
in unit testing. Nothing I wrote is inconsistent or contrary to the
advice in Kent Beck's "Test-Driven Development", Jeff Langr's "Modern
C++ Programming with Test-Driven Development", Freeman & Pryce's
"Growing Object-Oriented Software, Guided by Tests", Gerard Meszaros's
"xUnit Test Patterns: Refactoring Test Code", and so-on.

In other words, I documented the typical industry practice. I think
this is important for people who are new to unit testing. They should
work *with* the accepted norms before they develop enough skill and
expertise to know *when* and *how* they should deviate from them.

>In my opinion I have expressed desire to work with anyone on new
>documentation, who is willing and interested. This offer still stands.

Then you'll obviously be taking my pull request when I issue it soon.

"The Direct3D Graphics Pipeline" free book <>
     The Computer Graphics Museum <>
         The Terminals Wiki <>
  Legalize Adulthood! (my blog) <>

Boost list run by bdawes at, gregod at, cpdaniel at, john at