This file is indexed.

/usr/share/doc/geographiclib/html/intro.html is in geographiclib-tools 1.8-2.

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
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>GeographicLib: Introduction</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li class="current"><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
      <li><a href="annotated.html"><span>Classes</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="dirs.html"><span>Directories</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>Introduction </h1>  </div>
</div>
<div class="contents">
<center> Forward to <a class="el" href="organization.html">Code organization</a>. Up to <a class="el" href="index.html#contents">Contents</a>. </center><p>GeographicLib offers a C++ interfaces to a small (but important!) set of geographic transformations. It grew out of a desire to improve on the <a href="http://earth-info.nima.mil/GandG/geotrans/">geotrans</a> package for transforming between geographic and MGRS coordinates. At present, GeographicLib provides UTM, UPS, MGRS, geocentric, and local cartesian projections, geoid heights, and classes for geodesic calculations.</p>
<p>The goals of GeographicLib are:</p>
<ul>
<li>Accuracy. In most applications the accuracy is close to round-off, about 5 nm. Even though in many geographic applications 1 cm is considered "accurate enough", there is little penalty in providing much better accuracy. If situations where a faster approximate algorithm is necessary, GeographicLib offers an accurate benchmark to guide the development.</li>
<li>Completeness. For each of the projections included, an attempt is made to provide a complete solution. For example, <a class="el" href="classGeographicLib_1_1Geodesic.html#ad7e59a242125a35a95c96cdb20573081">GeographicLib::Geodesic::Inverse</a> works for anti-podal points. Similarly, <a class="el" href="classGeographicLib_1_1Geocentric.html#a7766e10bb3436647db9e2af896b05c51">GeographicLib::Geocentric.Reverse</a> will return accurate geodetic coordinates even for points close to the center of the earth.</li>
<li>C++ interface. For the projection methods, this allows encapsulation of the ellipsoid parameters.</li>
<li>Emphasis on projections necessary for analysing military data.</li>
<li>Uniform treatment of UTM/UPS. The <a class="el" href="classGeographicLib_1_1UTMUPS.html" title="Convert between Geographic coordinates and UTM/UPS.">GeographicLib::UTMUPS</a> class treats UPS as zone 0. This simplifies conversions between UTM and UPS coordinates, etc.</li>
<li>Well defined and stable conventions for the conversion between UTM/UPS to MGRS coordinates.</li>
<li>Detailed internal documentation on the algorithms. For the most part GeographicLib uses published algorithms and references are given. If changes have been made (usually to improve the numerical accuracy), these are described in the code.</li>
</ul>
<p>Various <a class="el" href="utilities.html">Utility Programs</a> are provided with the library. These illustrate the use of the library and are useful in their own right. This library and the utilities have been tested with g++ 4.4 under Linux, with g++ 4.2 under Mac OS X, and with MS Visual Studio 2008.</p>
<p>The section <a class="el" href="transversemercator.html">Transverse Mercator Projection</a> documents various properties of this projection.</p>
<p>The section <a class="el" href="geodesic.html">Geodesics on the Ellipsoid</a> documents (still rather incompletely) the method of solving the geodesic problem.</p>
<p>Undoubtedly, bugs lurk in this code and in the documentation. Please report any you find to &lt;<a href="mailto:charles@karney.com">charles@karney.com</a>&gt;.</p>
<center> Forward to <a class="el" href="start.html">Getting Started</a>. Up to <a class="el" href="index.html#contents">Contents</a>. </center> </div>
<hr class="footer"/><address class="footer"><small>Generated on Tue Feb 22 2011 for GeographicLib by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.1 </small></address>
</body>
</html>