[16362] in Kerberos_V5_Development
Re: standardizing copyright/license notice delimiters in MIT source
daemon@ATHENA.MIT.EDU (Will Fiveash)
Tue Sep 21 14:12:58 2010
Date: Tue, 21 Sep 2010 13:12:42 -0500
From: Will Fiveash <will.fiveash@oracle.com>
To: Greg Hudson <ghudson@mit.edu>
Message-ID: <20100921181242.GB16193@sun.com>
Mail-Followup-To: Greg Hudson <ghudson@mit.edu>,
"krbdev@mit.edu" <krbdev@mit.edu>
MIME-Version: 1.0
Content-Disposition: inline
In-Reply-To: <1285092261.20521.120.camel@ray>
Cc: "krbdev@mit.edu" <krbdev@mit.edu>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: krbdev-bounces@mit.edu
On Tue, Sep 21, 2010 at 02:04:21PM -0400, Greg Hudson wrote:
> Here's a proposal for updating the coding standards based on conference
> call discussion:
>
> * Each applicable copyright and license statement should appear in its
> own block comment (not combined with the filename or file description).
>
> * Copyright and license statements should appear before the first
> non-blank non-comment line of the file. (So, no more putting copyright
> statements in the middle of files if they only apply to part of the
> file.)
>
> * Copyright and license block comments should begin with the word
> "Copyright" or "License".
>
> We had a brief discussion of whether it's useful to identify the
> filename in the top comments, with one of us saying that it's sometimes
> useful. Assuming we keep that, prototype.c might look like:
>
> /* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */
> /* prototype/prototype.c */
> /*
> * Copyright (C) 2010 by the Massachusetts Institute of Technology.
> * All rights reserved.
> *
> * Export of this software from the United States of America may
> * require a specific license from the United States Government.
> * It is the responsibility of any person or organization contemplating
> * export to obtain such a license before exporting.
> *
> * WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
> * distribute this software and its documentation for any purpose and
> * without fee is hereby granted, provided that the above copyright
> * notice appear in all copies and that both that copyright notice and
> * this permission notice appear in supporting documentation, and that
> * the name of M.I.T. not be used in advertising or publicity pertaining
> * to distribution of the software without specific, written prior
> * permission. Furthermore if you modify this software you must label
> * your software as modified software and not distribute it in such a
> * fashion that it might be confused with the original M.I.T. software.
> * M.I.T. makes no representations about the suitability of
> * this software for any purpose. It is provided "as is" without express
> * or implied warranty.
> */
>
> /*
> * <<< Description >>>
> */
That looks good to me. Note that if more than one copyright/license
applies to a file then the comments would look something like:
/* -*- mode: c; c-basic-offset: 4; indent-tabs-mode: nil -*- */
/* prototype/prototype.c */
/*
* Copyright (C) 2010 by the Massachusetts Institute of Technology.
* All rights reserved.
*
* Export of this software from the United States of America may
* require a specific license from the United States Government.
* It is the responsibility of any person or organization contemplating
* export to obtain such a license before exporting.
*
* WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
* distribute this software and its documentation for any purpose and
* without fee is hereby granted, provided that the above copyright
* notice appear in all copies and that both that copyright notice and
* this permission notice appear in supporting documentation, and that
* the name of M.I.T. not be used in advertising or publicity pertaining
* to distribution of the software without specific, written prior
* permission. Furthermore if you modify this software you must label
* your software as modified software and not distribute it in such a
* fashion that it might be confused with the original M.I.T. software.
* M.I.T. makes no representations about the suitability of
* this software for any purpose. It is provided "as is" without express
* or implied warranty.
*/
/*
* Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
*/
/*
* <<< Description >>>
*/
--
Will Fiveash
Oracle
http://opensolaris.org/os/project/kerberos/
Sent using mutt, a sweet text based e-mail app: http://www.mutt.org/
_______________________________________________
krbdev mailing list krbdev@mit.edu
https://mailman.mit.edu/mailman/listinfo/krbdev
