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. Matthias