Boost logo

Boost :

From: Matthias Troyer (troyer_at_[hidden])
Date: 2005-09-09 01:31:52

On Sep 9, 2005, at 3:04 AM, Robert Ramey wrote:

> David Abrahams wrote:
>> IMO you ought to recognize that and not be so quick to
>> argue with someone who is reporting that the docs are hard to use and
>> suggesting ways to improve them, especially when that person has been
>> through that cycle many times with his own users and learnt from his
>> mistakes.
> lol - I've made lots of changes in documentation and in code in
> response to
> user reports that something doesn't make sense or is hard to
> understand.
> I've acknowledged that I struggled to find a good way to make such a
> document. I've conceded a number of specific points on which I
> decided I
> was wrong and agreed to make changes. Somethings I don't agree
> with and
> I've labored to explain my reasons. Other points require more
> consideration
> on my part. And some points we'll just have to agree to disagree.
> Sorry.

FWIW, I've tried to code a few archive types over the past year and
reading the documentation alone was not sufficient. I had to look at
the source codes of your archives to see how to actually write an
archive. This should not be necessary.


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