Return-Path: <cmcclanahan@mytownnet.com>
Mailing-List: contact tomcat-dev-help@jakarta.apache.org; run by ezmlm
Delivered-To: mailing list tomcat-dev@jakarta.apache.org
Received: (qmail 19136 invoked from network); 21 Oct 1999 00:05:06 -0000
Received: from unknown (HELO mytown.us.world.net) (209.162.210.179)
  by apache.org with SMTP; 21 Oct 1999 00:05:06 -0000
Received: from mytownnet.com ([209.241.199.22]) by mytown.us.world.net
          (Netscape Messaging Server 3.01)  with ESMTP id AAA11054
          for <tomcat-dev@jakarta.apache.org>;
          Wed, 20 Oct 1999 17:08:31 -0700
Message-ID: <380E58AB.7A7B17A7@mytownnet.com>
Date: Wed, 20 Oct 1999 17:05:00 -0700
From: "Craig McClanahan" <cmcclanahan@mytownnet.com>
Organization: MyTown Network, Incorporated
X-Mailer: Mozilla 4.61 [en] (Win95; I)
X-Accept-Language: en
MIME-Version: 1.0
To: tomcat-dev@jakarta.apache.org
Subject: Re: source code standards!!!!!
References: <B4339E7D.7A3E%jon@clearink.com>
 <380E5156.FB7DA463@gefionsoftware.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

Hans Bergsten wrote:

> jon * wrote:
> >
> > on 10/20/99 4:22 PM, arun@hyperreal.org at arun@hyperreal.org wrote:
> >
> > > +
> > > +    public HttpURLConnection
> > > + getConnection(Hashtable headers, Hashtable queryString, String pathInfo,
> > > +        String method, boolean useCookie)
> > > + throws Exception {
> > > + this.useCookie = useCookie;
> > > + return getCon(headers, doQueryString(queryString), pathInfo, method);
> > > +    }
> >
> > hey all, i'm seeing checkins with a lot of tabs or bad formatting or both.
> > can we please agree on a standard?
>
> I agree, the code is hard to read with all the different conventions (or no
> convention ;-) being used. I would also appreciate if everyone followed the
> http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html like we say
> on the site that we should.

I agree.  On the specific topic of tabs, though, note the first sentence of the
"Indentation" section (#4):

    Four spaces should be used as the unit of indentation. The exact construction
    of the indentation (spaces vs. tabs) is unspecified. Tabs must be set exactly
    every 8 spaces (not 4).

Thus, tabs themselves are not evil unless you set them for other than 8 characters
in your editor.

<flameproof underwear>
Emacs, in conjunction with a nice Java editing mode, makes the tab key smart -- it
follows the indentation rule described above automatically by pressing it once,
because it always knows the current indentation level.  It also is quite smart
about aligning the parts of multiline statements sanely.
</flameproof underwear>

Craig