Return-Path: Delivered-To: apmail-xml-cocoon-dev-archive@xml.apache.org Received: (qmail 74158 invoked by uid 500); 14 Aug 2001 11:51:57 -0000 Mailing-List: contact cocoon-dev-help@xml.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: cocoon-dev@xml.apache.org Delivered-To: mailing list cocoon-dev@xml.apache.org Received: (qmail 74142 invoked from network); 14 Aug 2001 11:51:57 -0000 From: "Carsten Ziegeler" To: Subject: AW: [C2] Ambiguous API - AbstractServerPage.modifiedSince(long date) Date: Tue, 14 Aug 2001 13:52:38 +0200 Message-ID: MIME-Version: 1.0 X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2911.0) X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4522.1200 In-Reply-To: Importance: Normal X-MIMETrack: Itemize by SMTP Server on PBSN1/Systeme und Netzwerke(Release 5.0.5 |September 22, 2000) at 14.08.2001 13:51:55, Serialize by Router on PBSN1/Systeme und Netzwerke(Release 5.0.5 |September 22, 2000) at 14.08.2001 13:51:55, Serialize complete at 14.08.2001 13:51:55 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="us-ascii" X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N > Stuart Roebuck wrote: > > > I wonder whether it would be worth considering renaming and/or clarifying > the documentation of the modifiedSince() method defined in the Modifiable > interface? The uses of this method in Cocoon appear to fit with the > description of the method as implemented in AbstractServerPage, however > this definition is probably the exact opposite of what you would expect > for a method of this name, and I'm not sure that it is in keeping > with the > description in Modifiable.java. > > I would expect modifiedSince(date) to mean "has this object been modified > since the given date, if it has return true". > > But the implementation is "has this object been modified since the given > date, if *not* return true". > > Unfortunately, I can't think of a better name than: > needsRefreshingGivenLastAffectingChangeDateOf(Date dateOfLastUpdate) :-) > Let me guess, you are a long time OpenStep (Cocoa, WebObjects) user? Right? If so, welcome. If not, you have managed half the way of learning it. Carsten > Stuart. > > ------------------------------------------------------------------------- > Stuart Roebuck stuart.roebuck@adolos.com > Lead Developer Java, XML, MacOS X, XP, etc. > ADOLOS > > --------------------------------------------------------------------- > To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org > For additional commands, email: cocoon-dev-help@xml.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org For additional commands, email: cocoon-dev-help@xml.apache.org