Boilerplate File Header

Every file should include two comment header blocks, one for the Doxygen output and a copyright notice. This is a typical example:

/**
 * @file
 *
 * @ingroup TheGroupForThisFile
 *
 * @brief Short "Table of Contents" Description of File Contents
 *
 * A short description of the purpose of this file.
 */

/*
 * COPYRIGHT (c) 1989-2012.
 * On-Line Applications Research Corporation (OAR).
 *
 * The license and distribution terms for this file may be
 * found in the file LICENSE in this distribution or at
 * http://www.rtems.com/license/LICENSE.
 */

• Use exactly one blank line between the Doxygen header and copyright notice. Leave the first line of the copyright notice blank.
• Separate the Doxygen header and copyright notice so the copyright notice is not included in the Doxygen output.
• The copyright owner and specific license terms may vary.