I like this because, 1. It tells me it is a BSD license (which the BSD license at the bottom doesn't) 2 . Then the stuff that tells me if the file is interesting (as per Joel's comment) 3. Then the license
Just my thruppence worth ;-) Andrew > On 21 Feb 2020, at 14:26, Sebastian Huber > <sebastian.hu...@embedded-brains.de> wrote: > > We can keep the BSD-2-Clause text in the file. We can also keep the @file on > the top. Example: > > /* SPDX-License-Identifier: BSD-2-Clause */ > > /** > * @file > * > * @ingroup RTEMSApplicationConfiguration > * > * @brief Evaluate Configuration Options > * > * This header file includes a couple of header files which evaluate the > * configuration options specified by the application. The macros and defines > * used to configure the system are documented in the Configuring a System > * chapter of the Classic API User's Guide. > */ > > /* > * Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) > * Copyright (C) 1989, 2000 On-Line Applications Research Corporation (OAR) > * > * Redistribution and use in source and binary forms, with or without > * modification, are permitted provided that the following conditions > * are met: > * 1. Redistributions of source code must retain the above copyright > * notice, this list of conditions and the following disclaimer. > * 2. Redistributions in binary form must reproduce the above copyright > * notice, this list of conditions and the following disclaimer in the > * documentation and/or other materials provided with the distribution. > * > * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" > * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE > * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE > * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE > * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR > * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF > * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS > * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN > * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) > * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE > * POSSIBILITY OF SUCH DAMAGE. > */ > -------------------------------------------------------------------- Andrew Butterfield Tel: +353-1-896-2517 Fax: +353-1-677-2204 Lero@TCD, Head of Software Foundations & Verification Research Group School of Computer Science and Statistics, Room G.39, O'Reilly Institute, Trinity College, University of Dublin http://www.scss.tcd.ie/Andrew.Butterfield/ --------------------------------------------------------------------
_______________________________________________ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel