Hans Moser wrote:
Howard Chu schrieb:
>> Is tool-threads documented somewhere?
> Quanah already responded. But I have to ask - why in the world do you
> even need to ask a question like this? Just look in the man page
> first, then it will be obvious that it is (or isn't) documented.
> Is it really faster and more efficient for you to email hundreds or
> thousands of people with a question, than to look at the man pages
> already distributed with the software?
You are right.
But on the other hand: Why does not someone get the most recent
information on the project web site itself?
When he checked the web man page on openldap.org
, he got old information.
You cannot blame someone for checking "your" official source of
information, can you?
The web site only provides one or two snapshots of the manpages. There
are 30 releases of 2.2 and getting to 30 releases of 2.3. It is
unreasonable to expect that the documentation on the web site matches
the specific version of the software you're running. Common sense says
that the only version of the documentation that is reliable enough to
use is the version that was included with the particular release you're
At least you should add an disclaimer on the side to tell people:
"Recent information is only available with the source tarball."
It's not a question of "recent" vs "not recent" - it's a
"exactly matching" or not. Reading docs for a different version of
software than you're currently running will only cause confusion, as has
been demonstrated numerous times on this list.
A set of software and manpages are collected together for a reason. If
you're going to ignore the docs that are provided in the particular
distro you download, that's your own concern.
-- Howard Chu
Chief Architect, Symas Corp. http://www.symas.com
Director, Highland Sun http://highlandsun.com/hyc
OpenLDAP Core Team http://www.openldap.org/project/