~ubuntu-branches/ubuntu/natty/cobertura/natty

« back to all changes in this revision

Viewing changes to debian/cobertura-report.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Miguel Landaeta
  • Date: 2010-05-11 19:21:46 UTC
  • mfrom: (0.1.4 sid) (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20100511192146-j742v5jsl89ztndu
Tags: 1.9.4.1+dfsg-2
* Now Build-Depends on libservlet2.5-java and add a missing Depends
  on the same package. (Closes: #580842). 
* Simplify list of JRE dependences for cobertura and drop JRE dependences for
  libcobertura-java as Java libraries are no longer required to depend on a
  JVM.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
 
2
 
 
3
<!-- Process this file with docbook-to-man to generate an nroff manual
 
4
     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
 
5
     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
 
6
     less'.  A typical entry in a Makefile or Makefile.am is:
 
7
 
 
8
manpage.1: manpage.sgml
 
9
        docbook-to-man $< > $@
 
10
 
 
11
    
 
12
        The docbook-to-man binary is found in the docbook-to-man package.
 
13
        Please remember that if you create the nroff version in one of the
 
14
        debian/rules file targets (such as build), you will need to include
 
15
        docbook-to-man in your Build-Depends control field.
 
16
 
 
17
  -->
 
18
 
 
19
  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
 
20
  <!ENTITY dhfirstname "<firstname>Miguel</firstname>">
 
21
  <!ENTITY dhsurname   "<surname>Landaeta</surname>">
 
22
  <!-- Please adjust the date whenever revising the manpage. -->
 
23
  <!ENTITY dhdate      "<date>January 19, 2010</date>">
 
24
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
 
25
       allowed: see man(7), man(1). -->
 
26
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
 
27
  <!ENTITY dhemail     "<email>miguel@miguel.cc</email>">
 
28
  <!ENTITY dhusername  "Miguel Landaeta">
 
29
  <!ENTITY dhucpackage "<refentrytitle>COBERTURA-REPORT</refentrytitle>">
 
30
  <!ENTITY dhpackage   "cobertura-report">
 
31
 
 
32
  <!ENTITY debian      "<productname>Debian</productname>">
 
33
  <!ENTITY gnu         "<acronym>GNU</acronym>">
 
34
]>
 
35
 
 
36
<refentry>
 
37
  <refentryinfo>
 
38
    <address>
 
39
      &dhemail;
 
40
    </address>
 
41
    <author>
 
42
      &dhfirstname;
 
43
      &dhsurname;
 
44
    </author>
 
45
    <copyright>
 
46
      <year>2010</year>
 
47
      <holder>&dhusername;</holder>
 
48
    </copyright>
 
49
    &dhdate;
 
50
  </refentryinfo>
 
51
  <refmeta>
 
52
    &dhucpackage;
 
53
 
 
54
    &dhsection;
 
55
  </refmeta>
 
56
  <refnamediv>
 
57
    <refname>&dhpackage;</refname>
 
58
 
 
59
    <refpurpose>generate coverage reports</refpurpose>
 
60
  </refnamediv>
 
61
  <refsynopsisdiv>
 
62
    <cmdsynopsis>
 
63
      <command>&dhpackage;</command>
 
64
 
 
65
      <arg><option>--datafile file</option></arg>
 
66
      <arg choice="req">--destination dir</arg>
 
67
      <arg><option>--format html|xml</option></arg>
 
68
      <arg><option>--encoding encoding</option></arg>
 
69
      <arg choice="req">directory</arg>
 
70
      <arg><option>--basedir dir</option></arg>
 
71
 
 
72
    </cmdsynopsis>
 
73
  </refsynopsisdiv>
 
74
  <refsect1>
 
75
    <title>DESCRIPTION</title>
 
76
 
 
77
    <para><command>&dhpackage;</command> generates coverage reports from the
 
78
      source code directories and calculates the cyclomatic code complexity
 
79
      of each class. The HTML reports are also made of annotated versions
 
80
      of each source file, showing which lines of code were excercised. 
 
81
    </para>
 
82
 
 
83
  </refsect1>
 
84
  <refsect1>
 
85
    <title>OPTIONS</title>
 
86
 
 
87
    <variablelist>
 
88
      <varlistentry>
 
89
        <term><option>--datafile file</option>
 
90
        </term>
 
91
        <listitem>
 
92
          <para>Specify the name of the file containing metadata about your
 
93
            classes. Default value: "./cobertura.ser".</para>
 
94
        </listitem>
 
95
      </varlistentry>
 
96
      <varlistentry>
 
97
        <term><option>--basedir dir</option>
 
98
        </term>
 
99
        <listitem>
 
100
          <para>Specify a directory containing source code. All files listed
 
101
            after this are assumed to be underneath this directory. This
 
102
            should only be used if you want to include only a few specific
 
103
            files underneath a source tree and exclude all other files.
 
104
          </para>
 
105
        </listitem>
 
106
      </varlistentry>
 
107
      <varlistentry>
 
108
        <term><option>--destination dir</option>
 
109
        </term>
 
110
        <listitem>
 
111
          <para>
 
112
            Specify the output directory for the report.</para>
 
113
        </listitem>
 
114
      </varlistentry>
 
115
      <varlistentry>
 
116
        <term><option>--format xml|html</option>
 
117
        </term>
 
118
        <listitem>
 
119
          <para>
 
120
            The type of report you want to generate. Default value: html.
 
121
          </para>
 
122
        </listitem>
 
123
      </varlistentry>
 
124
      <varlistentry>
 
125
        <term><option>--encoding encoding</option>
 
126
        </term>
 
127
        <listitem>
 
128
          <para>Specify the encoding used to read the source. See javadocs for
 
129
            java.nio.charset.Charset for more details.</para>
 
130
        </listitem>
 
131
      </varlistentry>
 
132
    </variablelist>
 
133
  </refsect1>
 
134
  <refsect1>
 
135
    <title>SEE ALSO</title>
 
136
 
 
137
    <para>junit(1), cobertura-instrument(1), cobertura-check(1),
 
138
      cobertura-merge(1).</para>
 
139
 
 
140
  </refsect1>
 
141
  <refsect1>
 
142
    <title>AUTHOR</title>
 
143
 
 
144
    <para>This manual page was written by &dhusername; &lt;&dhemail;&gt;
 
145
      for the &debian; system (but may be used by others).  Permission is
 
146
      granted to copy, distribute and/or modify this document under
 
147
      the terms of the terms of &gnu; General Public License, Version 2 
 
148
      or any later version published by the Free Software Foundation.
 
149
    </para>
 
150
    <para>On Debian systems, the complete text of the GNU General Public
 
151
      License can be found in /usr/share/common-licenses/GPL.
 
152
    </para>
 
153
 
 
154
  </refsect1>
 
155
</refentry>
 
156
 
 
157
<!-- Keep this comment at the end of the file
 
158
Local variables:
 
159
mode: sgml
 
160
sgml-omittag:t
 
161
sgml-shorttag:t
 
162
sgml-minimize-attributes:nil
 
163
sgml-always-quote-attributes:t
 
164
sgml-indent-step:2
 
165
sgml-indent-data:t
 
166
sgml-parent-document:nil
 
167
sgml-default-dtd-file:nil
 
168
sgml-exposed-tags:nil
 
169
sgml-local-catalogs:nil
 
170
sgml-local-ecat-files:nil
 
171
End:
 
172
-->
 
173
 
 
174