Boost logo

Boost :

Subject: [boost] [string_algo] Documentation Complaint
From: Dave Abrahams (dave_at_[hidden])
Date: 2012-11-01 15:33:49

Wow, I found this documentation hard to use!

I wanted to translate various 1-character substrings into new strings,
e.g. translate the TAB character ('\t') to its textual escaped
representation "\\t", and I went looking for an algorithm to do it.

After 5 minutes of searching, I *think* the algorithm isn't there, but
I'm still not sure.

I nearly went blind (well, not really, but it felt that way) looking at
because there's no vertical whitespace. More importantly, there's *no
description of what any of these algorithms actually do*!

... calming down ...

Heh, very terse descriptions are in the "Quick Reference":
These might be good enough for me, but I always figure I'm going to get
complete detail from the non-quick reference, and this one is just a
dump of all the declarations, so I had to go around in a big circle and
begin writing this documentation complaint before I found it.

Can this situation be improved?

Dave Abrahams
BoostPro Computing                  Software Development        Training             Clang/LLVM/EDG Compilers  C++  Boost

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