📄 prs.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta name="generator" content="HTML Tidy, see www.w3.org"><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><link type="text/css" rel="stylesheet" href="style.css"><!-- Generated by The Open Group's rhtm tool v1.2.1 --><!-- Copyright (c) 2001-2003 The Open Group, All Rights Reserved --><title>prs</title></head><body bgcolor="white"><script type="text/javascript" language="JavaScript" src="../jscript/codes.js"></script><basefont size="3"> <a name="prs"></a> <a name="tag_04_103"></a><!-- prs --> <!--header start--><center><font size="2">The Open Group Base Specifications Issue 6<br>IEEE Std 1003.1, 2003 Edition<br>Copyright © 2001-2003 The IEEE and The Open Group, All Rights reserved.</font></center><!--header end--><hr size="2" noshade><h4><a name="tag_04_103_01"></a>NAME</h4><blockquote>prs - print an SCCS file (<b>DEVELOPMENT</b>)</blockquote><h4><a name="tag_04_103_02"></a>SYNOPSIS</h4><blockquote class="synopsis"><div class="box"><code><tt><sup>[<a href="javascript:open_code('XSI')">XSI</a>]</sup> <img src="../images/opt-start.gif" alt="[Option Start]" border="0"> prs</tt> <b>[</b><tt>-a</tt><b>][</b><tt>-d</tt><i>dataspec</i><b>][</b><tt>-r</tt><b>[</b><i>SID</i><b>]]</b> <i>file</i><tt>...<img src="../images/opt-end.gif" border="0"><br><br></tt><div class="box"><code><tt><sup>[<a href="javascript:open_code('XSI')">XSI</a>]</sup> <img src="../images/opt-start.gif" alt="[Option Start]" border="0"> prs</tt> <b>[</b> <tt>-e| -l</tt><b>]</b> <tt>-c</tt> <i>cutoff</i> <b>[</b><tt>-d</tt><i>dataspec</i><b>]</b> <i>file</i><tt>...<img src="../images/opt-end.gif" border="0"><br><br></tt><div class="box"><code><tt><sup>[<a href="javascript:open_code('XSI')">XSI</a>]</sup> <img src="../images/opt-start.gif" alt="[Option Start]" border="0"> prs</tt> <b>[</b> <tt>-e| -l</tt><b>]</b> <tt>-r</tt><b>[</b><i>SID</i><b>][</b><tt>-d</tt><i>dataspec</i><b>]</b><i>file</i><tt>...<img src="../images/opt-end.gif" border="0"><br></tt></code></div></code></div></code></div></blockquote><h4><a name="tag_04_103_03"></a>DESCRIPTION</h4><blockquote><p>The <i>prs</i> utility shall write to standard output parts or all of an SCCS file in a user-supplied format.</p></blockquote><h4><a name="tag_04_103_04"></a>OPTIONS</h4><blockquote><p>The <i>prs</i> utility shall conform to the Base Definitions volume of IEEE Std 1003.1-2001, <a href="../basedefs/xbd_chap12.html#tag_12_02">Section 12.2, Utility Syntax Guidelines</a>, except that the <b>-r</b> option has anoptional option-argument. This optional option-argument cannot be presented as a separate argument. The following options shall besupported:</p><dl compact><dt><b>-d </b> <i>dataspec</i></dt><dd>Specify the output data specification. The <i>dataspec</i> shall be a string consisting of SCCS file <i>data</i><i>keywords</i> (see <a href="#tag_04_103_10_01">Data Keywords</a> ) interspersed with optional user-supplied text.</dd><dt><b>-r[</b><i>SID</i><b>]</b></dt><dd>Specify the SCCS identification string (SID) of a delta for which information is desired. If no <i>SID</i> option-argument isspecified, the SID of the most recently created delta shall be assumed.</dd><dt><b>-e</b></dt><dd>Request information for all deltas created earlier than and including the delta designated via the <b>-r</b> option or thedate-time given by the <b>-c</b> option.</dd><dt><b>-l</b></dt><dd>Request information for all deltas created later than and including the delta designated via the <b>-r</b> option or thedate-time given by the <b>-c</b> option.</dd><dt><b>-c </b> <i>cutoff</i></dt><dd>Indicate the <i>cutoff</i> date-time, in the form: <pre><i>YY</i><b>[</b><i>MM</i><b>[</b><i>DD</i><b>[</b><i>HH</i><b>[</b><i>MM</i><b>[</b><i>SS</i><b>]]]]]</b></pre><p>For the <i>YY</i> component, values in the range [69,99] shall refer to years 1969 to 1999 inclusive, and values in the range[00,68] shall refer to years 2000 to 2068 inclusive. <basefont size="2"></p><dl><dt><b>Note:</b></dt><dd>It is expected that in a future version of IEEE Std 1003.1-2001 the default century inferred from a 2-digit year willchange. (This would apply to all commands accepting a 2-digit year as input.)</dd></dl><basefont size="3"> <p>No changes (deltas) to the SCCS file that were created after the specified <i>cutoff</i> date-time shall be included in theoutput. Units omitted from the date-time default to their maximum possible values; for example, <b>-c 7502</b> is equivalentto <b>-c 750228235959</b>.</p></dd><dt><b>-a</b></dt><dd>Request writing of information for both removed-that is, <a href="../utilities/delta.html"><i>delta</i></a> <i>type</i>=<i>R</i> (see <a href="rmdel.html"><i>rmdel</i></a> )- and existing-that is, <a href="../utilities/delta.html"><i>delta</i></a><i>type</i>= <i>D</i>,- deltas. If the <b>-a</b> option is not specified, information for existing deltas only shall beprovided.</dd></dl></blockquote><h4><a name="tag_04_103_05"></a>OPERANDS</h4><blockquote><p>The following operand shall be supported:</p><dl compact><dt><i>file</i></dt><dd>A pathname of an existing SCCS file or a directory. If <i>file</i> is a directory, the <i>prs</i> utility shall behave asthough each file in the directory were specified as a named file, except that non-SCCS files (last component of the pathname doesnot begin with <b>s.</b>) and unreadable files shall be silently ignored. <p>If exactly one <i>file</i> operand appears, and it is <tt>'-'</tt> , the standard input shall be read; each line of the standardinput shall be taken to be the name of an SCCS file to be processed. Non-SCCS files and unreadable files shall be silentlyignored.</p></dd></dl></blockquote><h4><a name="tag_04_103_06"></a>STDIN</h4><blockquote><p>The standard input shall be a text file used only when the <i>file</i> operand is specified as <tt>'-'</tt> . Each line of thetext file shall be interpreted as an SCCS pathname.</p></blockquote><h4><a name="tag_04_103_07"></a>INPUT FILES</h4><blockquote><p>Any SCCS files displayed are files of an unspecified format.</p></blockquote><h4><a name="tag_04_103_08"></a>ENVIRONMENT VARIABLES</h4><blockquote><p>The following environment variables shall affect the execution of <i>prs</i>:</p><dl compact><dt><i>LANG</i></dt><dd>Provide a default value for the internationalization variables that are unset or null. (See the Base Definitions volume ofIEEE Std 1003.1-2001, <a href="../basedefs/xbd_chap08.html#tag_08_02">Section 8.2, Internationalization Variables</a> forthe precedence of internationalization variables used to determine the values of locale categories.)</dd><dt><i>LC_ALL</i></dt><dd>If set to a non-empty string value, override the values of all the other internationalization variables.</dd><dt><i>LC_CTYPE</i></dt><dd>Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte asopposed to multi-byte characters in arguments and input files).</dd><dt><i>LC_MESSAGES</i></dt><dd>Determine the locale that should be used to affect the format and contents of diagnostic messages written to standarderror.</dd><dt><i>NLSPATH</i></dt><dd>Determine the location of message catalogs for the processing of <i>LC_MESSAGES .</i></dd></dl></blockquote><h4><a name="tag_04_103_09"></a>ASYNCHRONOUS EVENTS</h4><blockquote><p>Default.</p></blockquote><h4><a name="tag_04_103_10"></a>STDOUT</h4><blockquote><p>The standard output shall be a text file whose format is dependent on the data keywords specified with the <b>-d</b> option.</p><h5><a name="tag_04_103_10_01"></a>Data Keywords</h5><p>Data keywords specify which parts of an SCCS file shall be retrieved and output. All parts of an SCCS file have an associateddata keyword. A data keyword may appear in a <i>dataspec</i> multiple times.</p><p>The information written by <i>prs</i> shall consist of:</p><ol><li><p>The user-supplied text</p></li><li><p>Appropriate values (extracted from the SCCS file) substituted for the recognized data keywords in the order of appearance in the<i>dataspec</i></p></li></ol><p>The format of a data keyword value shall either be simple ( <tt>'S'</tt> ), in which keyword substitution is direct, ormulti-line ( <tt>'M'</tt> ).</p><p>User-supplied text shall be any text other than recognized data keywords. A <tab> shall be specified by <tt>'\t'</tt> and<newline> by <tt>'\n'</tt> . When the <b>-r</b> option is not specified, the default <i>dataspec</i> shall be:</p><pre><tt>:PN::\n\n</tt></pre><p>and the following <i>dataspec</i> shall be used for each selected delta:</p><pre><tt>:Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:</tt></pre><center><table border="1" cellpadding="3" align="center"><tr valign="top"><th colspan="5" align="center"><p class="tent"><b>SCCS File Data Keywords</b></p></th></tr><tr valign="top"><th align="center"><p class="tent"><b>Keyword</b></p></th><th align="center"><p class="tent"><b>Data Item</b></p></th><th align="center"><p class="tent"><b>File Section</b></p></th><th align="center"><p class="tent"><b>Value</b></p></th><th align="center"><p class="tent"><b>Format</b></p></th></tr><tr valign="top"><td align="left"><p class="tent"><b>:Dt:</b></p></td><td align="left"><p class="tent">Delta information</p></td><td align="center"><p class="tent">Delta Table</p></td><td align="left"><p class="tent"><b>See below*</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:DL:</b></p></td><td align="left"><p class="tent">Delta line statistics</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b>:Li:/:Ld:/:Lu:</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Li:</b></p></td><td align="left"><p class="tent">Lines inserted by Delta</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnnn</i>***</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Ld:</b></p></td><td align="left"><p class="tent">Lines deleted by Delta</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnnn</i>***</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Lu:</b></p></td><td align="left"><p class="tent">Lines unchanged by Delta</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnnn</i>***</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:DT:</b></p></td><td align="left"><p class="tent">Delta type</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b>D or R</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:I:</b></p></td><td align="left"><p class="tent">SCCS ID string (SID)</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b>See below**</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:R:</b></p></td><td align="left"><p class="tent">Release number</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:L:</b></p></td><td align="left"><p class="tent">Level number</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:B:</b></p></td><td align="left"><p class="tent">Branch number</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:S:</b></p></td><td align="left"><p class="tent">Sequence number</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:D:</b></p></td><td align="left"><p class="tent">Date delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b>:Dy:/:Dm:/:Dd:</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Dy:</b></p></td><td align="left"><p class="tent">Year delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Dm:</b></p></td><td align="left"><p class="tent">Month delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Dd:</b></p></td><td align="left"><p class="tent">Day delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:T:</b></p></td><td align="left"><p class="tent">Time delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b>:Th:::Tm:::Ts:</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Th:</b></p></td><td align="left"><p class="tent">Hour delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Tm:</b></p></td><td align="left"><p class="tent">Minutes delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Ts:</b></p></td><td align="left"><p class="tent">Seconds delta created</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:P:</b></p></td><td align="left"><p class="tent">Programmer who created Delta</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>logname</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:DS:</b></p></td><td align="left"><p class="tent">Delta sequence number</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:DP:</b></p></td><td align="left"><p class="tent">Predecessor Delta sequence</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b><i>nnnn</i></b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b> </b></p></td><td align="left"><p class="tent">number</p></td><td align="center"><p class="tent"> </p></td><td align="left"><p class="tent"><b> </b></p></td><td align="center"><p class="tent"> </p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:DI:</b></p></td><td align="left"><p class="tent">Sequence number of deltas</p></td><td align="center"><p class="tent">"</p></td><td align="left"><p class="tent"><b>:Dn:/:Dx:/:Dg:</b></p></td><td align="center"><p class="tent">S</p></td></tr><tr valign="top"><td align="left"><p class="tent"><b> </b></p></td><td align="left"><p class="tent">included, excluded, or ignored</p></td><td align="center"><p class="tent"> </p></td><td align="left"><p class="tent"><b> </b></p></td><td align="center"><p class="tent"> </p></td></tr><tr valign="top"><td align="left"><p class="tent"><b>:Dn:</b></p></td><td align="left"><p class="tent">Deltas included (sequence #)</p></td><td align="center"><p class="tent">"</p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -