Dave --
...and then David Yitzchak Cohen said...
%
% On Fri, Dec 05, 2003 at 09:34:02AM -0500, David T-G wrote:
%
% > 1) When you failed to find reply-hook in the stable docs on the web site,
% > why didn't you try looking locally at your unstable package?
%
% My unstable package doesn't have human-readable docs, so I have an easy
% answer to that one ;-)
But it should, so I have an easy retort :-) :-)
%
% > 2) Who on earth would update the docs for the world to see with features
% > that not only aren't available yet
%
% Excuse me, the development tarballs (and even the CVS versions) _are_
% available for the world to use, so why shouldn't their manuals be
They are in the same way that the devel code is -- in the devel sources!
% available for the same world to see? ("No no, I can't tell you how to
% use this program. It's a development version. You've gotta figure it
% out for yourself in order to attain a deeper understanding of the Tao
% of Mutterin'. Hint: UTF [1] to RTS [2], dude!")
Ha ha :-)
IMHO, you're missing the point; the docs on the web page are for the
stable version. I could accept the argument that perhaps devel docs
should *also* be available for reading on the web site, but never that
they should replace the stable version.
%
% > but might change or go away before
% > release
%
% Since the code has been released already, I'd say the devs kinda missed
% that boat ... unless they want to "unrelease" the 1.5.x branch ... and if
% they can unrelease the code, they can just as easily unrelease the docs,
% so who cares?
Sorry; while I meant "release" as "release as a stable version", I did
not necessarily make that clear.
%
% > -- AND which, for all we know, could be flat-out wrong for the
% > current version?
%
% Um, the 1.4.x docs were undoubtably the basis for the 1.5.x docs,
Sure.
% so the doctrine of higher_version==better (which tends to hold in the
% open source world) would indicate that the 1.5.x docs are probably less
% flat-out wrong for the 1.5.x code than the 1.4.x docs are. In other
Certainly, but they'd be all sorts of wrong for the 1.4 code. Imagine
the poor guy who kept posting to the list asking why his reply-hooks
never did anything even though he had followed the docs religiously!
% words, dev docs are better than no dev docs.
Yep. And that's why you get them in the dev package.
%
% - Dave
%
% [1]
% UTF == Use The Force
%
% [2]
% RTS == Read The Source
HTH & HAND
:-D
--
David T-G * There is too much animal courage in
(play) davidtg@xxxxxxxxxxxxxxx * society and not sufficient moral courage.
(work) davidtgwork@xxxxxxxxxxxxxxx -- Mary Baker Eddy, "Science and Health"
http://justpickone.org/davidtg/ Shpx gur Pbzzhavpngvbaf Qrprapl Npg!
Attachment:
pgpG4EvKhyrDC.pgp
Description: PGP signature