From 9c755172c22c2fe318f285b8b5041c2f8fb4b4d7 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Sun, 2 Dec 2018 11:29:33 -0600 Subject: coding-doxygen-bsp.rst, coding-file-hdr.rst: Fix formatting --- eng/coding-file-hdr.rst | 55 ++++++++++++++++++++++++++----------------------- 1 file changed, 29 insertions(+), 26 deletions(-) (limited to 'eng/coding-file-hdr.rst') diff --git a/eng/coding-file-hdr.rst b/eng/coding-file-hdr.rst index 23e5db0..1ff16b8 100644 --- a/eng/coding-file-hdr.rst +++ b/eng/coding-file-hdr.rst @@ -9,32 +9,35 @@ 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: -.. code block:: shell -/** - * @file - * - * @ingroup TheGroupForThisFile - * - * @brief Short "Table of Contents" Description of File Contents - * - * A short description of the purpose of this file. - */ - -/* - * Copyright (c) 20XX Your Name Or Your Company. - * - * The license and distribution terms for this file may be - * found in the file LICENSE in this distribution or at - * https://www.rtems.org/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. + .. code-block:: c + + /** + * @file + * + * @ingroup TheGroupForThisFile + * + * @brief Short "Table of Contents" Description of File Contents + * + * A short description of the purpose of this file. + */ + + /* + * Copyright (c) 20XX Your Name Or Your Company. + * + * The license and distribution terms for this file may be + * found in the file LICENSE in this distribution or at + * https://www.rtems.org/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. + +TBD Add link to license requirements section and show variant licenses. -- cgit v1.2.3