This file is indexed.

/usr/share/doc/mcl/html/mclblastline.html is in mcl-doc 1:14-137-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
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (c) 2014 Stijn van Dongen -->
<head>
<meta name="keywords" content="manual">
<style type="text/css">
/* START aephea.base.css */
body
{ text-align: justify;
margin-left: 0%;
margin-right: 0%;
}
a:link { text-decoration: none; }
a:active { text-decoration: none; }
a:visited { text-decoration: none; }
a:link { color: #1111aa; }
a:active { color: #1111aa; }
a:visited { color: #111166; }
a.local:link { color: #11aa11; }
a.local:active { color: #11aa11; }
a.local:visited { color: #116611; }
a.intern:link { color: #1111aa; }
a.intern:active { color: #1111aa; }
a.intern:visited { color: #111166; }
a.extern:link { color: #aa1111; }
a.extern:active { color: #aa1111; }
a.extern:visited { color: #661111; }
a.quiet:link { color: black; }
a.quiet:active { color: black; }
a.quiet:visited { color: black; }
div.verbatim
{ font-family: monospace;
margin-top: 1em;
margin-bottom: 1em;
font-size: 10pt;
margin-left: 2em;
white-space: pre;
}
div.indent
{ margin-left: 8%;
margin-right: 0%;
}
.right { text-align: right; }
.left { text-align: left; }
.nowrap { white-space: nowrap; }
.item_leader
{ position: relative;
margin-left: 8%;
}
.item_compact { position: absolute; vertical-align: baseline; }
.item_cascade { position: relative; }
.item_leftalign { text-align: left; }
.item_rightalign
{ width: 2em;
text-align: right;
}
.item_compact .item_rightalign
{ position: absolute;
width: 52em;
right: -2em;
text-align: right;
}
.item_text
{ position: relative;
margin-left: 3em;
}
.smallcaps { font-size: smaller; text-transform: uppercase }
/* END aephea.base.css */
body { font-family: "Garamond", "Gill Sans", "Verdana", sans-serif; }
body
{ text-align: justify;
margin-left: 8%;
margin-right: 8%;
}
</style>
<title>The mclblastline manual</title>
</head>
<body>
<p style="text-align:right">
16 May 2014&nbsp;&nbsp;&nbsp;
<a class="local" href="mclblastline.ps"><b>mclblastline</b></a>
14-137
</p>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">1.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#name">NAME</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">2.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#synopsis">SYNOPSIS</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">3.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#description">DESCRIPTION</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">4.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#options">OPTIONS</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">5.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#examples">EXAMPLES</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">6.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#author">AUTHOR</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">7.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#sealso">SEE ALSO</a>
</div>
</div>

<a name="name"></a>
<h2>NAME</h2>
<p style="margin-bottom:0" class="asd_par">
mclblastline &mdash; a pipeline for clustering from BLAST files.</p>

<a name="synopsis"></a>
<h2>SYNOPSIS</h2>
<p style="margin-top:0em; margin-bottom:0em">
<b>mclblastline</b> file-name</p>
<p style="margin-bottom:0" class="asd_par">
<b>mclblastline</b> [deblast options] [pipeline options] file-name</p>
<p style="margin-bottom:0"><b>NOTE</b><br>
<b>mcl</b> has acquired the ability to proceed from label input
as produced by <b>mcxdeblast</b>. This enables a very lightweight
mechanism of generating clusterings from BLAST files.
You might want to use this mechanism,
documented in the <a class="local sibling" href="mcl.html">mcl manual</a>.</p>
<p style="margin-bottom:0"><b>NOTE</b><br>
mclblastline used to require (given default parameters)
the presence of the <b>zoem</b> macro processor to produce detailed output.
This is no longer the case. By default mclblastline now creates
a line-based tab-separated dump file.
Zoem <i>will</i> be invoked when the --fmt-fancy option is supplied.
In that case, zoem obviously has to be installed.</p>

<a name="description"></a>
<h2>DESCRIPTION</h2>
<p style="margin-top:0em; margin-bottom:0em">
<b>mclblastline</b> wraps around <b>mclpipeline</b>. It supplies the
<b>--parser</b>=<i>app</i>
and <b>--parser-tag</b>=<i>str</i> options, setting them respectively
to <i>mcxdeblast</i> and <i>blast</i>. This tells
<a class="local sibling" href="mclpipeline.html">mclpipeline</a> to use
<a class="local sibling" href="mcxdeblast.html">mcxdeblast</a> as the parse script in its pipeline.
The significance of
the <i>blast</i> tag is that any mcxdeblast option can be passed through
mclblastline and mclpipeline by inserting this tag into the option.
For example, mcxdeblast accepts the <b>--score</b>=<i>x</i> option.
When using mclblastline, you specify it as <b>--blast-score</b>=<i>x</i>.
There are two exceptions to this rule, namely the
<b>--xi-dat</b>=<i>str</i> and <b>--xo-dat</b>=<i>str</i> options. Refer to
the <a class="local sibling" href="mclpipeline.html">mclpipeline</a> manual for more information.</p>
<p style="margin-bottom:0" class="asd_par">
Additionally, all mclpipeline options are acceptable to <a class="local sibling" href="mcxdeblast.html">mcxdeblast</a> as
well. The <b>--whatif</b> is useful for getting a feel for the pipeline.
The <b>--mcl-I</b>=<i>f</i> inflation option and <b>--mcl-scheme</b>=<i>i</i> scheme
index options are your basic means for respectively manipulating cluster
granularity and allocating resources. Read the <a class="local sibling" href="mcl.html">mcl</a> manual entries for
a description of the corresponding <b>-I</b> and <b>-scheme</b> mcl
options.</p>
<p style="margin-bottom:0" class="asd_par">
The best advice is to glance over the <a class="local sibling" href="mcxdeblast.html">mcxdeblast</a> and <a class="local sibling" href="mclpipeline.html">mclpipeline</a>
options in order to get a feeling for which of those may come in handy for
you. Then start experimenting. Use the <b>--whatif</b> option, it will
tell you what would happen without actually doing it.</p>

<a name="options"></a>
<h2>OPTIONS</h2>
<p style="margin-top:0em; margin-bottom:0em">
All <a class="local sibling" href="mcxdeblast.html">mcxdeblast</a> and <a class="local sibling" href="mclpipeline.html">mclpipeline</a> options.
mcxdeblast options must be passed using the mechanism described above.</p>

<a name="examples"></a>
<h2>EXAMPLES</h2>
<div class="verbatim">   mclblastline --blast-score=b
      --blast-sort=a --blast-bcut=5 --mcl-I=2.5 myblastfile</div>
<p style="margin-top:0em; margin-bottom:0em">
This will use bit scores, sort cluster indices such that the corresponding
labels are ordered alphabetically, ignore bit scores not exceeding 5, and
use inflation value 2.5. In this case, the output clustering will be in the
file named <tt>myblastfile.I25s2</tt> (I25 identifying the inflation value and s2
identifying the resource scheme) and the formatted output will be in the
file <tt>myblastfile.I25s2.fmt</tt>.</p>
<div class="verbatim">   mclblastline --prepare-mcl myblastfile
   mclblastline --start-mcl --mcl-I=1.2 myblastfile
   mclblastline --start-mcl --mcl-I=1.6 myblastfile
   mclblastline --start-mcl --mcl-I=2.0 myblastfile
   mclblastline --start-mcl --mcl-I=2.4 myblastfile
   mclblastline --start-mcl --mcl-I=2.8 myblastfile
   etc ..</div>
<p style="margin-top:0em; margin-bottom:0em">
The first run prepares an input matrix to be read by <b>mcl</b>.
In this case its file will be named <tt>myblastfile.sym</tt>.
The subsequent runs use this matrix.
<b>CAVEAT</b> there are some options that you need to repeat
when executing such a resumed run. They are clearly marked
in the <a class="local sibling" href="mclpipeline.html">mclpipeline</a> manual - namely those options
that affect names of (intermediate) files. Most importantly,
this concerns the mclpipeline options that have prefix
<b>--xo</b> or <b>--xi</b>. For example,</p>
<div class="verbatim">   mclblastline --prepare-mcl --blast-score=b --xo-dat=b myblastfile
   mclblastline --start-mcl --xo-dat=b --mcl-I=1.2 myblastfile
   mclblastline --start-mcl --xo-dat=b --mcl-I=1.6 myblastfile
   mclblastline --start-mcl --xo-dat=b --mcl-I=2.0 myblastfile
   mclblastline --start-mcl --xo-dat=b --mcl-I=2.4 myblastfile
   mclblastline --start-mcl --xo-dat=b --mcl-I=2.8 myblastfile
   etc ..</div>
<p style="margin-bottom:0" class="asd_par">
In this case, the matrix file will be named <tt>myblastfile.b.sym</tt>,
and the <b>--xo-dat</b> options must be repeated in all runs
so that the pipeline reconstructs the correct file name(s).</p>

<a name="author"></a>
<h2>AUTHOR</h2>
<p style="margin-bottom:0" class="asd_par">
Stijn van Dongen</p>

<a name="sealso"></a>
<h2>SEE ALSO</h2>
<p style="margin-bottom:0" class="asd_par">
<a class="local sibling" href="mcxdeblast.html">mcxdeblast</a>, <a class="local sibling" href="mclpipeline.html">mclpipeline</a>, <a class="local sibling" href="mcxassemble.html">mcxassemble</a>.</p>
</body>
</html>