This file is indexed.

/usr/share/doc/libdeal.ii-dev/README.Debian.html is in libdeal.ii-dev 6.3.1-1.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
<html><head><title>deal.II Debian Package</title></head>
  <body><center><h1><a href="http://dealii.org/">deal.II</a> Debian
	Package</h1>
      <p>Adam C. Powell, IV<br/>
	Last updated July 20, 2009 for version 6.2.1-1</p></center>

    <p>This page documents the Debian packaging for the deal.II finite element
      library.  You can read more about the library itself in the deal.ii-doc
      package documentation.</p>

    <hr/>

    <h3>Package organization</h3>

    <p>The deal.ii source package builds six binary packages:</p>

    <ul>
      <li><tt>libdeal.ii-dev</tt> contains symbolic links to the optimized
	shared libraries using the deal.II library names, all of the header
	files in <tt>/usr/include/deal.II</tt>, and all of the <tt>common/</tt>
	files in <tt>/usr/share/deal.II</tt></li>
      <li><tt>libdeal.ii6.2.1</tt> contains the optimized shared
	libraries</li>
      <li><tt>libdeal.ii-dbg</tt> contains symbolic links to the debugging
	shared libraries using the deal.II library names</li>
      <li><tt>libdeal.ii-dbg6.2.1</tt> contains the debugging shared
	libraries</li>
      <li><tt>deal.ii-doc</tt> contains all of the documentation, including
	that generated from source code by doxygen</li>
      <li><tt>deal.ii-examples</tt> contains the source code of tutorial
	examples, whose documentation is in the <tt>deal.ii-doc</tt>
	package</li>
    </ul>

    <p>To run the examples in the <tt>-examples</tt> package, you should be
      able to do:</p>

    <dl><dd><tt>cp -a /usr/share/doc/deal.ii-examples/step-1 .<br/>
	  cd step-1<br/>
	  make run</tt></dd></dl>

    <p>If this doesn't work, with step-1 or any of the other examples, please
      report the bug.</p>

    <h3>Known bugs</h3>

    (This section will go away when the package enters Debian and these can go
    into the Bug Tracking System.)

    <ul>
      <li>The <tt>Makefiles</tt> in the -examples package do not work.</li>
      <li>These libraries do not link directly to the PETSc libraries on which
	they depend, but on the <tt>libpetsccall[.g].so</tt> library which in
	turn links to the PETSc libraries.  This is not good linking practice;
	they should link directly instead.</li>
      <li>It is not clear that the debugging and optimized libraries are
	significantly different, or are even linked from different object
	files.  The Debian packaging doesn't strip debugging symbols from the
	debugging libraries, but at this point that is the only known
	difference.</li>
    </ul>

    <hr/>
  </body>
</html>