On Tue, 2005-11-10 at 18:55 -0700, David Fetter wrote:
> IMHO, yes, and no, respectively. If there's an example, there's fewer
> frustrated people pestering lists about it.
There is something to be said for brevity: spending a lot of prose on an
example of an obscure problem means the documentation is more difficult
to understand and less useful to most users.
Of course, that's not to say this particular problem is sufficiently
obscure that an example isn't worthwhile (I don't really know) -- but
the attitude that examples are always good is misguided IMHO.
-Neil
