From api-return-16-apmail-directory-api-archive=directory.apache.org@directory.apache.org Fri Nov 27 12:10:50 2009 Return-Path: Delivered-To: apmail-directory-api-archive@minotaur.apache.org Received: (qmail 14844 invoked from network); 27 Nov 2009 12:10:50 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 27 Nov 2009 12:10:50 -0000 Received: (qmail 38862 invoked by uid 500); 27 Nov 2009 10:24:10 -0000 Delivered-To: apmail-directory-api-archive@directory.apache.org Received: (qmail 38839 invoked by uid 500); 27 Nov 2009 10:24:10 -0000 Mailing-List: contact api-help@directory.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: api@directory.apache.org Delivered-To: mailing list api@directory.apache.org Received: (qmail 38829 invoked by uid 99); 27 Nov 2009 10:24:10 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 27 Nov 2009 10:24:10 +0000 X-ASF-Spam-Status: No, hits=-4.0 required=10.0 tests=RCVD_IN_DNSWL_MED,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: local policy) Received: from [192.18.6.21] (HELO gmp-eb-inf-1.sun.com) (192.18.6.21) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 27 Nov 2009 10:24:00 +0000 Received: from fe-emea-10.sun.com (gmp-eb-lb-1-fe1.eu.sun.com [192.18.6.7] (may be forged)) by gmp-eb-inf-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id nARANd1Z024293 for ; Fri, 27 Nov 2009 10:23:39 GMT MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; CHARSET=US-ASCII; format=flowed Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) id <0KTR00300IXI1T00@fe-emea-10.sun.com> for api@directory.apache.org; Fri, 27 Nov 2009 10:23:19 +0000 (GMT) Received: from [192.168.1.12] ([unknown] [82.122.129.87]) by fe-emea-10.sun.com (Sun Java(tm) System Messaging Server 7u2-7.04 64bit (built Jul 2 2009)) with ESMTPSA id <0KTR0055PJIV9T00@fe-emea-10.sun.com> for api@directory.apache.org; Fri, 27 Nov 2009 10:23:19 +0000 (GMT) Date: Fri, 27 Nov 2009 11:23:18 +0100 From: Matthew Swift Subject: Re: Let's start for real ? In-reply-to: <6D888D9C-17B1-40F2-B642-C5621256FF46@sun.com> Sender: Matthew.Swift@Sun.COM To: api@directory.apache.org Message-id: <4B0FA896.1080500@sun.com> References: <4B0C0163.9040607@nextury.com> <6D888D9C-17B1-40F2-B642-C5621256FF46@sun.com> User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.1.6pre) Gecko/20091126 Shredder/3.0.1pre X-Virus-Checked: Checked by ClamAV on apache.org Hi Emmanuel > Also those names are not the final ones. The idea is to discuss about > the exact names we will use. For instance, DN is not necessarily the > most common form. Many APIs or implementations are using LdapDn or > LdapDN. Assuming that the Java naming convention requires that the first > letter only to be upcased, one can think that Dn or Rdn is a better name. > I think that this convention applies to words in Java names, and not necessarily abbreviations such as DN. In fact a cursory look through the JDK6/J2EE6 APIs will reveal that there is definitely no convention! Take a look at javax.xml.* where they seem to mix XML/Xml and HTTP/Http and various other well known abbreviations with gay abandon :-) My personal preference and our convention here has been to use uppercase for abbreviations, but I don't feel so strongly to let such a detail get in the way of progress. I think that the most important things to focus on are to make the SDK easy to learn and easy to use and that means keeping it small, clean, and consistent. Matt