W3C home > Mailing lists > Public > www-dom@w3.org > January to March 2004

Re: L3 Core: "this", "reference" and 'given" nodes muddled in description of compareDocumentPosition and related constants

From: Fred L. Drake, Jr. <fdrake@acm.org>
Date: Wed, 7 Jan 2004 10:17:22 -0500
Message-ID: <16380.8962.173988.390755@sftp.fdrake.net>
To: Joseph Kesselman <keshlam@us.ibm.com>
Cc: www-dom@w3.org

Joseph Kesselman writes:
 > As an alternative to "other node", we could also consider "parameter node"
 > or "node passed as a parameter"... a bit more verbose but avoids any
 > question about the intent.

Couldn't the name of the parameter be used?  This seems an easy way to
keep the text both simple and clear.

 > (I'd almost be tempted to render "this" in boldface when we're using it as
 > a keyword to signify the-node-which-is-performing-the-operation, but I
 > don't think I can see the WG on that idea.)

Ugh.  It would have to be defined somewhere as well; not all languages
prefer "this" as the name for the object on which the method is being
called.  (Of course, I don't know of any really good way to refer to
that object with having a defined keyword of some sort in the text.)


Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation
Received on Wednesday, 7 January 2004 10:17:32 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 20 October 2015 10:46:12 UTC