📄 x-coding2.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><link rel="STYLESHEET" type="text/css" href="wrs.css"><title> Coding Conventions </title></head><body bgcolor="FFFFFF"><p class="navbar" align="right"><a href="index.html"><img border="0" alt="[Contents]" src="icons/contents.gif"></a><a href="GuideIX.html"><img border="0" alt="[Index]" src="icons/index.gif"></a><a href="x-coding.html"><img border="0" alt="[Top]" src="icons/top.gif"></a><a href="x-coding1.html"><img border="0" alt="[Prev]" src="icons/prev.gif"></a><a href="x-coding3.html"><img border="0" alt="[Next]" src="icons/next.gif"></a></p><font face="Helvetica, sans-serif" class="sans"><h3 class="H2"><i><a name="84378">I.2 File Heading</a></i></h3></font><dl class="margin"><dl class="margin"><dd><p class="Body"><a name="84379"> </a>Every file containing C code--whether it is a header file, a resource file, or a file that implements a host tool, a library of routines, or an application--must contain a <i class="emphasis">standard file heading</i>. The conventions in this section define the standard for the heading that must come at the beginning of every source file.</p><dd><p class="Body"><a name="84382"> </a>The file heading consists of the blocks described below. The blocks are separated by one or more empty lines and contain no empty lines within the block. This facilitates automated processing of the heading.</p></dl><dl class="margin"><p class="listspace"><ul class="Bullet" type="disc"><li><a name="84383"> </a><font face="Helvetica, sans-serif" size="-1" class="sans"><b class="hb">Title:</b></font> The title consists of a one-line comment containing the tool, library, or applications name followed by a short description. The name must be the same as the file name. This line will become the title of automatically generated reference entries and indexes.</li></ul></p><p class="listspace"><ul class="Bullet" type="disc"><li><a name="84384"> </a><font face="Helvetica, sans-serif" size="-1" class="sans"><b class="hb">Copyright:</b></font> The copyright consists of a single-line comment containing the appropriate copyright information.</li></ul></p><p class="listspace"><ul class="Bullet" type="disc"><li><a name="84385"> </a><font face="Helvetica, sans-serif" size="-1" class="sans"><b class="hb">Modification History:</b></font> The modification history consists of a comment block: in C, a multi-line comment. Each entry in the modification history consists of the version number, date of modification, initials of the programmer who made the change, and a complete description of the change. If the modification fixes an SPR, then the modification history must include the SPR number.</li></ul></p><dl class="margin"><dd><div class="Indent"><a name="84386"> </a>The version number is a two-digit number and a letter (for example, 03c). The letter is incremented for internal changes, and the number is incremented for large changes, especially those that materially affect the module's external interface.</div><br></dl></dl><dl class="margin"><dd><p class="Body"><a name="84387"> </a>The following example shows a standard file heading from a C source file:</p></dl></dl><h4 class="EntityTitle"><a name="84388"><font face="Helvetica, sans-serif" size="-1" class="sans">Example I-1: Standard File Heading (C Version)</font></a></h4><dl class="margin"><dl class="margin"><dd><pre class="Code"><b><a name="84389">/* fooLib.c - foo subroutine library */ /* Copyright 1984-1995 Wind River Systems, Inc. */ /* modification history -------------------- 02a,15sep92,nfs added defines MAX_FOOS and MIN_FATS. 01b,15feb86,dnw added routines fooGet() and fooPut(); added check for invalid index in fooFind(). 01a,10feb86,dnw written. */</a></b></pre></dl></dl><a name="foot"><hr></a><p class="navbar" align="right"><a href="index.html"><img border="0" alt="[Contents]" src="icons/contents.gif"></a><a href="GuideIX.html"><img border="0" alt="[Index]" src="icons/index.gif"></a><a href="x-coding.html"><img border="0" alt="[Top]" src="icons/top.gif"></a><a href="x-coding1.html"><img border="0" alt="[Prev]" src="icons/prev.gif"></a><a href="x-coding3.html"><img border="0" alt="[Next]" src="icons/next.gif"></a></p></body></html><!---by WRS Documentation (), Wind River Systems, Inc. conversion tool: Quadralay WebWorks Publisher 4.0.11 template: CSS Template, Jan 1998 - Jefro --->⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -