/usr/share/covered/doc/html/chapter.exclude.html is in covered-doc 0.7.10-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 13. The exclude Command</title><link rel="stylesheet" href="covered.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.71.1"><link rel="start" href="index.html" title="Covered User's Guide - 0.7.9"><link rel="up" href="part.command.line.usage.html" title="Part III. Command-line Usage"><link rel="prev" href="chapter.rank.html" title="Chapter 12. The rank Command"><link rel="next" href="chapter.reading.html" title="Chapter 14. Reading the Report"><center><img src="img/banner.jpg"></center><hr></head><body bgcolor="#dfeef8" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 13. The exclude Command</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="chapter.rank.html"><img src="img/prev.gif" alt="Prev"></a> </td><th width="60%" align="center">Part III. Command-line Usage</th><td width="20%" align="right"> <a accesskey="n" href="chapter.reading.html"><img src="img/next.gif" alt="Next"></a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="chapter.exclude"></a>Chapter 13. The exclude Command</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="chapter.exclude.html#section.exclude.usage">13.1. Usage</a></span></dt><dt><span class="sect1"><a href="chapter.exclude.html#section.exclude.options">13.2. Options</a></span></dt></dl></div><p>
The exclude command allows the user to exclude uncovered coverage points from coverage (effectively
turning the uncovered points into covered points) or include coverage points that were previously
excluded. Additionally, the exclude command allows the user to specify a reason why the coverage
point is being excluded. This capability allows for good documentation of these coverage points for
later evaluation and can be output into various report formats to go along with a verification testplan.
</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.exclude.usage"></a>13.1. Usage</h2></div></div></div><p>
The exclude command is specified with the given call:
</p><p>
<code class="code">
covered [<span class="emphasis"><em>global options</em></span>] exclude [<span class="emphasis"><em>options</em></span>]
<span class="emphasis"><em>exclusion ID</em></span>+ <span class="emphasis"><em>CDD file</em></span>
</code>
</p><p>
The exclusion ID information can be obtained via a Covered report command call with the
<span class="bold"><strong>-d (d|v)</strong></span> and <span class="bold"><strong>-e</strong></span> options. Exclusion
IDs consist of an alphanumeric value that will be specified with parenthesis prior to a coverage point.
</p><p>
You may specify one or more exclusion IDs per call to the exclude command. If the
<span class="bold"><strong>-m</strong></span> option is specified, a prompt will be specified for each exclusion
ID, individually. If a coverage point is currently included in the CDD prior to an exclude call, the coverage
point will be toggled to be excluded and a user message can be attached to the coverage point, specifying
the reason for exclusion. If a coverage point is currently excluded in the CDD prior to an exclude call,
the coverage point will be toggled to be included and any previouly assigned user message will be forgotten.
</p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section.exclude.options"></a>13.2. Options</h2></div></div></div><p>
</p><div class="table"><a name="table.exclude.options"></a><p class="title"><b>Table 13.1. Options to the exclude command</b></p><div class="table-contents"><table summary="Options to the exclude command" border="1"><colgroup><col><col></colgroup><thead><tr><th>
Option
</th><th>
Description
</th></tr></thead><tbody><tr><td>
-f <span class="emphasis"><em>filename</em></span>
</td><td>
Allows the user to specify a file that contains additional exclude command options to parse.
This option may be specified more than once for a single call to the exclude command.
</td></tr><tr><td>
-h
</td><td>
Displays help information for the exclude command.
</td></tr><tr><td>
-m
</td><td>
Allows a user message specifying the reason for excluding any coverage points being excluded on
the command-line. An interactive prompt will be specified in the shell. Simply enter your reason
at the prompt, hit return and specify a single period (.) character followed by a return to end
the user input for a coverage point. You may use as many lines of text that you would like;
however, all formatting characters (i.e., newlines, tabs, extra spaces, etc.) will be removed
when reporting the information.
</td></tr><tr><td>
-p
</td><td>
Outputs the current exclusion status of the specified exclusion ID(s) and displays any exclusion
reason messages associated with the specified exclusion ID(s) to standard output.
</td></tr></tbody></table></div></div><p><br class="table-break">
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="chapter.rank.html"><img src="img/prev.gif" alt="Prev"></a> </td><td width="20%" align="center"><a accesskey="u" href="part.command.line.usage.html"><img src="img/up.gif" alt="Up"></a></td><td width="40%" align="right"> <a accesskey="n" href="chapter.reading.html"><img src="img/next.gif" alt="Next"></a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 12. The rank Command </td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="img/home.gif" alt="Home"></a></td><td width="40%" align="right" valign="top"> Chapter 14. Reading the Report</td></tr></table></div></body></html>
|