prs.html

IEEE 1003.1-2003, Single Unix Specification v3

</td>
<td align="left">
<p class="tent"><b>:DS: :DS: ...</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:Dx:</b></p>
</td>
<td align="left">
<p class="tent">Deltas excluded (sequence #)</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>:DS: :DS: ...</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:Dg:</b></p>
</td>
<td align="left">
<p class="tent">Deltas ignored (sequence #)</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>:DS: :DS: ...</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:MR:</b></p>
</td>
<td align="left">
<p class="tent">MR numbers for delta</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">M</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:C:</b></p>
</td>
<td align="left">
<p class="tent">Comments for delta</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">M</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:UN:</b></p>
</td>
<td align="left">
<p class="tent">User names</p>
</td>
<td align="center">
<p class="tent">User Names</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">M</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:FL:</b></p>
</td>
<td align="left">
<p class="tent">Flag list</p>
</td>
<td align="center">
<p class="tent">Flags</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">M</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:Y:</b></p>
</td>
<td align="left">
<p class="tent">Module type flag</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:MF:</b></p>
</td>
<td align="left">
<p class="tent">MR validation flag</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>yes or no</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:MP:</b></p>
</td>
<td align="left">
<p class="tent">MR validation program name</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:KF:</b></p>
</td>
<td align="left">
<p class="tent">Keyword error, warning flag</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>yes or no</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:KV:</b></p>
</td>
<td align="left">
<p class="tent">Keyword validation string</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:BF:</b></p>
</td>
<td align="left">
<p class="tent">Branch flag</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>yes or no</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:J:</b></p>
</td>
<td align="left">
<p class="tent">Joint edit flag</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>yes or no</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:LK:</b></p>
</td>
<td align="left">
<p class="tent">Locked releases</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>:R: ...</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:Q:</b></p>
</td>
<td align="left">
<p class="tent">User-defined keyword</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:M:</b></p>
</td>
<td align="left">
<p class="tent">Module name</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:FB:</b></p>
</td>
<td align="left">
<p class="tent">Floor boundary</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>:R:</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:CB:</b></p>
</td>
<td align="left">
<p class="tent">Ceiling boundary</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>:R:</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">Default SID</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>:I:</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:ND:</b></p>
</td>
<td align="left">
<p class="tent">Null delta flag</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b>yes or no</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:FD:</b></p>
</td>
<td align="left">
<p class="tent">File descriptive text</p>
</td>
<td align="center">
<p class="tent">Comments</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">M</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:BD:</b></p>
</td>
<td align="left">
<p class="tent">Body</p>
</td>
<td align="center">
<p class="tent">Body</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">M</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:GB:</b></p>
</td>
<td align="left">
<p class="tent">Gotten body</p>
</td>
<td align="center">
<p class="tent">"</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">M</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:W:</b></p>
</td>
<td align="left">
<p class="tent">A form of <i>what</i> string</p>
</td>
<td align="center">
<p class="tent">N/A</p>
</td>
<td align="left">
<p class="tent"><b>:Z::M:\t:I:</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:A:</b></p>
</td>
<td align="left">
<p class="tent">A form of <i>what</i> string</p>
</td>
<td align="center">
<p class="tent">N/A</p>
</td>
<td align="left">
<p class="tent"><b>:Z::Y: :M: :I::Z:</b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:Z:</b></p>
</td>
<td align="left">
<p class="tent"><i>what</i> string delimiter</p>
</td>
<td align="center">
<p class="tent">N/A</p>
</td>
<td align="left">
<p class="tent"><b><tt>@(#)</tt></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:F:</b></p>
</td>
<td align="left">
<p class="tent">SCCS filename</p>
</td>
<td align="center">
<p class="tent">N/A</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>

<tr valign="top">
<td align="left">
<p class="tent"><b>:PN:</b></p>
</td>
<td align="left">
<p class="tent">SCCS file pathname</p>
</td>
<td align="center">
<p class="tent">N/A</p>
</td>
<td align="left">
<p class="tent"><b><i>text</i></b></p>
</td>
<td align="center">
<p class="tent">S</p>
</td>
</tr>
</table>
</center>

<dl compact>
<dt>*</dt>

<dd><b>:Dt:</b>= <b>:DT: :I: :D: :T: :P: :DS: :DP:</b></dd>

<dt>**</dt>

<dd><b>:R:.:L:.:B:.:S:</b> if the delta is a branch delta ( <b>:BF:</b>== <b>yes</b>)<br>
<b>:R:.:L:</b> if the delta is not a branch delta ( <b>:BF:</b>== <b>no</b>)</dd>

<dt>***</dt>

<dd>The line statistics are capped at 99999. For example, if 100000 lines were unchanged in a certain revision, <b>:Lu:</b> shall
produce the value 99999.</dd>
</dl>
</blockquote>

<h4><a name="tag_04_103_11"></a>STDERR</h4>

<blockquote>
<p>The standard error shall be used only for diagnostic messages.</p>
</blockquote>

<h4><a name="tag_04_103_12"></a>OUTPUT FILES</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_103_13"></a>EXTENDED DESCRIPTION</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_103_14"></a>EXIT STATUS</h4>

<blockquote>
<p>The following exit values shall be returned:</p>

<dl compact>
<dt>&nbsp;0</dt>

<dd>Successful completion.</dd>

<dt>&gt;0</dt>

<dd>An error occurred.</dd>
</dl>
</blockquote>

<h4><a name="tag_04_103_15"></a>CONSEQUENCES OF ERRORS</h4>

<blockquote>
<p>Default.</p>
</blockquote>

<hr>
<div class="box"><em>The following sections are informative.</em></div>

<h4><a name="tag_04_103_16"></a>APPLICATION USAGE</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_103_17"></a>EXAMPLES</h4>

<blockquote>
<ol>
<li>
<p>The following example:</p>

<pre>
<tt>prs -d "User Names for :F: are:\n:UN:" s.file
</tt>
</pre>

<p>might write to standard output:</p>

<pre>
<tt>User Names for s.file are:
xyz
131
abc
</tt>
</pre>
</li>

<li>
<p>The following example:</p>

<pre>
<tt>prs -d "Delta for pgm :M:: :I: - :D: By :P:" -r s.file
</tt>
</pre>

<p>might write to standard output:</p>

<pre>
<tt>Delta for pgm main.c: 3.7 - 77/12/01 By cas
</tt>
</pre>
</li>

<li>
<p>As a special case:</p>

<pre>
<tt>prs s.file
</tt>
</pre>

<p>might write to standard output:</p>

<pre>
<tt>s.file:
&lt;</tt><i>blank line</i><tt>&gt;
D 1.1 77/12/01 00:00:00 cas 1 000000/00000/00000
MRs:
bl78-12345
bl79-54321
COMMENTS:
this is the comment line for s.file initial delta
&lt;</tt><i>blank line</i><tt>&gt;
</tt>
</pre>

<p>for each delta table entry of the <b>D</b> type. The only option allowed to be used with this special case is the <b>-a</b>
option.</p>
</li>
</ol>
</blockquote>

<h4><a name="tag_04_103_18"></a>RATIONALE</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_103_19"></a>FUTURE DIRECTIONS</h4>

<blockquote>
<p>None.</p>
</blockquote>

<h4><a name="tag_04_103_20"></a>SEE ALSO</h4>

<blockquote>
<p><a href="admin.html"><i>admin</i></a> , <a href="delta.html"><i>delta</i></a> , <a href="get.html"><i>get</i></a> , <a href=
"what.html"><i>what</i></a></p>
</blockquote>

<h4><a name="tag_04_103_21"></a>CHANGE HISTORY</h4>

<blockquote>
<p>First released in Issue 2.</p>
</blockquote>

<h4><a name="tag_04_103_22"></a>Issue 5</h4>

<blockquote>
<p>The phrase &quot;in which keyword substitution is followed by a &lt;newline&gt;&quot; is deleted from the end of the second paragraph of
<a href="#tag_04_103_10_01">Data Keywords</a> .</p>

<p>The interpretation of the <i>YY</i> component of the <b>-c</b> <i>cutoff</i> argument is noted.</p>
</blockquote>

<h4><a name="tag_04_103_23"></a>Issue 6</h4>

<blockquote>
<p>The normative text is reworded to emphasize the term &quot;shall&quot; for implementation requirements.</p>

<p>The Open Group Base Resolution bwg2001-007 is applied, updating the table in STDOUT with a note that line statistics are capped
at 99999 for the <b>:Li:</b>, <b>:Ld:</b>, <b>:Lu:</b>, and <b>:DL:</b> keywords.</p>

<p>The Open Group Interpretation PIN4C.00009 is applied.</p>
</blockquote>

<div class="box"><em>End of informative text.</em></div>

<hr>
<hr size="2" noshade>
<center><font size="2"><!--footer start-->
UNIX &reg; is a registered Trademark of The Open Group.<br>
POSIX &reg; is a registered Trademark of The IEEE.<br>
[ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
"../utilities/contents.html">XCU</a> | <a href="../functions/contents.html">XSH</a> | <a href="../xrat/contents.html">XRAT</a>
]</font></center>

<!--footer end-->
<hr size="2" noshade>
</body>
</html>