From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 8763 invoked by alias); 8 Apr 2004 15:21:57 -0000 Mailing-List: contact ecos-maintainers-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Post: List-Help: , Sender: ecos-maintainers-owner@sources.redhat.com Received: (qmail 8750 invoked from network); 8 Apr 2004 15:21:55 -0000 Date: Thu, 08 Apr 2004 15:21:00 -0000 To: Jonathan Larmour Cc: Andrew Lunn , Alex Schuilenburg , eCos Maintainers Subject: Re: [ECOS] Re: eCosCentric copyright hold in headers Message-ID: <20040408152255.GN29940@lunn.ch> References: <20040408101602.GJ29940@lunn.ch> <4075305D.8020101@eCosCentric.com> <20040408111939.GK29940@lunn.ch> <407556D4.8080407@ecoscentric.com> <40755B58.30905@eCosCentric.com> <20040408142145.GL29940@lunn.ch> <407567A2.3040106@eCosCentric.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <407567A2.3040106@eCosCentric.com> User-Agent: Mutt/1.5.5.1+cvs20040105i From: Andrew Lunn X-SW-Source: 2004-04/txt/msg00006.txt.bz2 On Thu, Apr 08, 2004 at 03:54:26PM +0100, Jonathan Larmour wrote: > Andrew Lunn wrote: > >Should we propose what the new banner looks like? > > > >Is the basic format of the current banner OK? > > I'd like it to be changed actually. Some of the information parts of the > banner are _very_ frequently poorly maintained and/or inaccurate and do us > a disservice. I think the Authors/Contributors bits are ambiguous; and the > Purpose/Description ditto. It's never really been clear what Date the Date > is for. I think I fill these in more than most people, but still rarely. > Contributions very frequently have inaccurate fields here, most annoyingly > the author. > > I think something like the following fields would be better/clearer: > > Maintained by: was derived from> > > Contributors: > Derived from: Description: > > I propose dropping the date entirely partly due to the ambiguity and partly > because it doesn't tell us anything we can't find out more accurately from > the changelogs. > > I propose dropping the mini-description underneath the filename at the top, > as it is usually no better than the description further down. Just to make that a bit more concrete i've made an example. //========================================================================== // // common/kapi.cxx // //========================================================================== //####ECOSGPLCOPYRIGHTBEGIN#### // ------------------------------------------- // This file is part of eCos, the Embedded Configurable Operating System. // Copyright (C) 2004 Free Software Foundation, Inc. // // eCos is free software; you can redistribute it and/or modify it under // the terms of the GNU General Public License as published by the Free // Software Foundation; either version 2 or (at your option) any later version. // // eCos is distributed in the hope that it will be useful, but WITHOUT ANY // WARRANTY; without even the implied warranty of MERCHANTABILITY or // FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License // for more details. // // You should have received a copy of the GNU General Public License along // with eCos; if not, write to the Free Software Foundation, Inc., // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. // // As a special exception, if other files instantiate templates or use macros // or inline functions from this file, or you compile this file and link it // with other works to produce a work based on this file, this file does not // by itself cause the resulting work to be covered by the GNU General Public // License. However the source code for this file must still be made available // in accordance with section (3) of the GNU General Public License. // // This exception does not invalidate any other reasons why a work based on // this file might be covered by the GNU General Public License. // // ------------------------------------------- //####ECOSGPLCOPYRIGHTEND#### //========================================================================== //#####DESCRIPTIONBEGIN#### // // Maintained by: nickg, dsm // Contributors: nickg // Derived from: // Description: C++ implementation of the C API // //####DESCRIPTIONEND#### // //========================================================================== I don't think this is going to be easy. Does dsm maintain this file? Andrew