From: "David Kennedy" <[EMAIL PROTECTED]> > Moving on - I'm delurking with an eye to contributing something, > work permitting, and have singled out commons Lang and Collections > as 'easy' places to start where I can concentrate on CVS and 'how > we do things' more than the actual code. There are quite a few docs > on the Jakarta site - if anyone has specific recommendations for > where to start or for good guides I'd welcome them.
Code patches, documentation patches and good old constructive criticism is always welcomed. And yes [lang] and [collections] are good places to start, just don't forget [lang] or [collections] in the email title ;-) Stephen > > David Kennedy > > On Tuesday, January 14, 2003, at 09:26 pm, Morgan Delagrange wrote: > > > Boy, is my face red. :) Well, then, I would agree > > that uppercase is better, even though mixed case is > > used throughout Catalina, certain Commons components, > > etc. > > > > - Morgan > > > > --- "Craig R. McClanahan" <[EMAIL PROTECTED]> wrote: > >> > >> > >> On Tue, 14 Jan 2003, Morgan Delagrange wrote: > >> > >>> Date: Tue, 14 Jan 2003 10:33:29 -0800 (PST) > >>> From: Morgan Delagrange <[EMAIL PROTECTED]> > >>> Reply-To: Jakarta Commons Developers List > >> <[EMAIL PROTECTED]>, > >>> [EMAIL PROTECTED] > >>> To: Jakarta Commons Developers List > >> <[EMAIL PROTECTED]> > >>> Subject: RE: Your commits to commons-configuration > >>> > >>> Not the J2EE JDK. > >>> > >>> > >> > > http://java.sun.com/j2ee/sdk_1.3/techdocs/api/javax/servlet/http/package-sum mary. > > html > >>> > >>> > >> > > http://java.sun.com/j2ee/sdk_1.3/techdocs/api/javax/servlet/jsp/package-summ ary. > > html > >>> > >> > >> Can't speak for all of J2EE, but at least in the > >> servlet spec, the > >> upper-lower case versions of the names were > >> deprecated and replaced by > >> uppercase-only versions in Servlet 2.1 (a *long* > >> time ago :-). Examples: > >> > >> javax.servlet.http.HttpRequest: > >> ------------------------------ > >> isRequestedSessionFromUrl() --> > >> isRequestedSessionFromURL() > >> > >> javax.servlet.http.HttpResponse: > >> ------------------------------- > >> encodeUrl() --> encodeURL() > >> encodeRedirectUrl() --> encodeRedirectURL() > >> > >> The upper case version is certainly the trend in > >> standard Java APIs, but > >> backwards compatibility requirements hamper how > >> quickly you can get rid of > >> past inconsistencies. > >> > >>> But I agree that it's inconclusive. Naughty, > >>> inconsistent Sun specs... > >>> > >>> - Morgan > >> > >> Craig > >> > >> > >>> > >>> --- "Krohn, Dave" <[EMAIL PROTECTED]> wrote: > >>>> Looking at the JDK itself: > >>>> > >>>> URL > >>>> URLClassLoader > >>>> SQLException > >>>> UIDefaults > >>>> > >>>> It seems that within the JDK Sun is pretty > >>>> consistent with all caps for > >>>> acronyms. > >>>> > >>>>> -----Original Message----- > >>>>> From: Morgan Delagrange > >>>> [mailto:[EMAIL PROTECTED]] > >>>>> Sent: Tuesday, January 14, 2003 12:13 PM > >>>>> To: Jakarta Commons Developers List > >>>>> Subject: Re: Your commits to > >> commons-configuration > >>>>> > >>>>> > >>>>> > >>>>> --- Kurt Schrader <[EMAIL PROTECTED]> > >> wrote: > >>>>>> On 14 Jan 2003, Henning Schmiedehausen > >> wrote: > >>>>>> > >>>>>>> According to Sun naming rules (and Apache > >>>>>> convention), even acronyms are > >>>>>>> written in the "first letter caps" rule in > >>>> method > >>>>>> and class names. So > >>>>>>> IMHO "XmlConfiguration" is better than > >>>>>> "XMLConfiguration". > >>>>>>> > >>>>>>> Same goes for "DOM4JConfiguration" vs. > >>>>>> "Dom4JConfiguration". > >>>>>>> > >>>>>>> I'd like to get these class names changed > >>>> back. > >>>>>> > >>>>>> The Sun naming rules don't say anything > >> about > >>>>>> acronyms. > >>>>> > >>>>> Actually they do talk about acroymns in class > >>>> names, > >>>>> they just don't seem to pin down the > >>>> capitalization: > >>>>> > >>>>> > >>>> > >>> > >> > > http://java.sun.com/docs/codeconv/html/CodeConventions.doc8.html > >>>>> > >>>>>> Effective Java (pg. 165) says: > >>>>>> > >>>>>> There is little consensus as to whether > >> acronyms > >>>>>> should be uppercase or > >>>>>> have only their first letter capitalized. > >>>>>> > >>>>>> Either way should be ok. > >>>>>> > >>>>>> -Kurt > >>>>>> > >>>>> > >>>>> I agree with Henning that the preponderance of > >>>> Apache > >>>>> classes seem to use mixed case for acroymns. > >>>> Also, > >>>>> recent Java packages ("javax.servlet", > >>>>> "javax.servlet.jsp" e.g.) seem to use mixed > >> case, > >>>> but > >>>>> older packages (e.g. "java.net") do not. I > >> think > >>>>> precedent supports Henning. > >>>>> > >>>>> - Morgan > >>>>> > >>>>> ===== > >>>>> Morgan Delagrange > >>>>> http://jakarta.apache.org/taglibs > >>>>> http://jakarta.apache.org/commons > >>>>> http://axion.tigris.org > >>>>> http://jakarta.apache.org/watchdog > >>>>> > >>>>> > >> __________________________________________________ > >>>>> Do you Yahoo!? > >>>>> Yahoo! Mail Plus - Powerful. Affordable. Sign > >> up > >>>> now. > >>>>> http://mailplus.yahoo.com > >>>>> > >>>>> -- > >>>>> To unsubscribe, e-mail: > >>>> > >> <mailto:[EMAIL PROTECTED]> > >>>> For additional commands, e-mail: > >>>> <mailto:[EMAIL PROTECTED]> > >>>> > >>> > >>> > >>> ===== > >>> Morgan Delagrange > >>> http://jakarta.apache.org/taglibs > >>> http://jakarta.apache.org/commons > >>> http://axion.tigris.org > >>> http://jakarta.apache.org/watchdog > >>> > >>> __________________________________________________ > >>> Do you Yahoo!? > >>> Yahoo! Mail Plus - Powerful. Affordable. Sign up > >> now. > >>> http://mailplus.yahoo.com > >>> > >>> -- > >>> To unsubscribe, e-mail: > >> <mailto:[EMAIL PROTECTED]> > >>> For additional commands, e-mail: > >> <mailto:[EMAIL PROTECTED]> > >>> > >>> > >> > >> > >> -- > >> To unsubscribe, e-mail: > >> <mailto:[EMAIL PROTECTED]> > >> For additional commands, e-mail: > >> <mailto:[EMAIL PROTECTED]> > >> > > > > > > ===== > > Morgan Delagrange > > http://jakarta.apache.org/taglibs > > http://jakarta.apache.org/commons > > http://axion.tigris.org > > http://jakarta.apache.org/watchdog > > > > __________________________________________________ > > Do you Yahoo!? > > Yahoo! Mail Plus - Powerful. Affordable. Sign up now. > > http://mailplus.yahoo.com > > > > -- > > To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]. > > org> > > For additional commands, e-mail: <mailto:[EMAIL PROTECTED]. > > org> > > > > > David Kennedy > [EMAIL PROTECTED] > > > -- > To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> > For additional commands, e-mail: <mailto:[EMAIL PROTECTED]> > -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
