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 ---------------------------(end of broadcast)--------------------------- TIP 5: don't forget to increase your free space map settings