This file is indexed.

/usr/share/doc/libbobcat3-dev/man/irandstream.3.html is in libbobcat-dev 3.19.01-1ubuntu1.

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
<html><head>
<title>FBB::IRandStream</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::IRandStream</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz</h2>
<h2>2005-2013</h2>

<html><head>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1></h1>

<html><head>
<title>FBB::IRandStream(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::IRandStream(3bobcat)</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz Random numbers istream</h2>
<h2>2005-2013</h2>


<p>
<h2>NAME</h2>FBB::IRandStream - Istream producing random numbers
<p>
<h2>SYNOPSIS</h2>
    <strong>#include &lt;bobcat/irandstream&gt;</strong><br>
    Linking option: <em>-lbobcat</em> 
<p>
<h2>DESCRIPTION</h2>
    <strong>FBB::IRandStream</strong> objects may be used to extract random numbers in a
given range from a stream.
<p>
<h2>NAMESPACE</h2>
    <strong>FBB</strong><br>
    All constructors, members, operators and manipulators, mentioned in this
man-page, are defined in the namespace <strong>FBB</strong>.
<p>
<h2>INHERITS FROM</h2>
    <strong>std::istream</strong>, <br>
    <strong>FBB::RandBuffer</strong> (private) 
<p>
<h2>CONSTRUCTORS</h2>
    <ul>
    <li> <strong>IRandStream(int max)</strong>:<br>
    This <strong>FBB::IRandStream()</strong> constructor initializes the random generator.
The default seed (i.e., 1) for the <strong>srand</strong>(3) function is used, meaning that
every new run of the program will generate the same sequence of random
values. Another constructor (see below) is provided when this is not
considered appropriate. Random values between 1 and <em>max</em> (inclusive) are
returned.
<p>
<li> <strong>IRandStream(int min, int max)</strong>:<br>
    This <strong>FBB::IRandStream()</strong> constructor initializes the random generator.
The default seed (i.e., 1) for the <strong>srand</strong>(3) function is used, meaning that
every new run of the program will generate the same sequence of random
values. Another constructor (see below) is provided when this is not
considered appropriate. Random values between <em>min</em> and <em>max</em> (inclusive)
are returned.
<p>
<li> <strong>IRandStream(int min, int max, int seed)</strong>:<br>
    This <strong>FBB::IRandStream()</strong> constructor initializes the random
generator. The seed is used to initialze the random number generator. To start
the random generator at some unpredictable point, <em>time(0)</em> could be used.
Random values between <em>min</em> and <em>max</em> (inclusive) are returned.
    </ul>
<p>
<h2>INHERITED MEMBERS</h2>
<p>
Since the class uses public derivation from <strong>std::istream</strong>, all members
of this class can be used.
<p>
<h2>EXAMPLE</h2>
    <pre>
#include &lt;iostream&gt;
#include &lt;bobcat/irandstream&gt;

using namespace std;
using namespace FBB;

int main(int argc, char **argv)
{
    IRandStream in(1000);

    for (; argc--; )
    {
        size_t random;
        in &gt;&gt; random;
        cout &lt;&lt; random &lt;&lt; endl;
    }

    return 0;
}

</pre>

<p>
<h2>FILES</h2>
    <em>bobcat/irandstream</em> - defines the class interface
<p>
<h2>SEE ALSO</h2>
    <strong>bobcat</strong>(7), <strong>randbuffer</strong>(3bobcat)
<p>
<h2>BUGS</h2>
    None Reported.
<p>

<h2>DISTRIBUTION FILES</h2>
    <ul>
    <li> <em>bobcat_3.19.01-x.dsc</em>: detached signature;
    <li> <em>bobcat_3.19.01-x.tar.gz</em>: source archive;
    <li> <em>bobcat_3.19.01-x_i386.changes</em>: change log;
    <li> <em>libbobcat1_3.19.01-x_*.deb</em>: debian package holding the
            libraries;
    <li> <em>libbobcat1-dev_3.19.01-x_*.deb</em>: debian package holding the
            libraries, headers and manual pages;
    <li> <em>http://sourceforge.net/projects/bobcat</em>: public archive location;
    </ul>
<p>
<h2>BOBCAT</h2>
    Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.
<p>
<h2>COPYRIGHT</h2>
    This is free software, distributed under the terms of the 
    GNU General Public License (GPL).
<p>
<h2>AUTHOR</h2>
    Frank B. Brokken (<strong>f.b.brokken@rug.nl</strong>).
<p>