Restructure the documentation to try and make it hang together better.
Majorly improved. Still a lot to do, but the structure is better.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@1324 a5019735-40e9-0310-863c-91ae7b9d1cf9
diff --git a/docs/manual.html b/docs/manual.html
index d367019..dee3496 100644
--- a/docs/manual.html
+++ b/docs/manual.html
@@ -26,7 +26,7 @@
<a name="title"> </a>
<h1 align=center>Valgrind, version 2.0.0</h1>
-<center>This manual was last updated on 10 November 2002</center>
+<center>This manual was last updated on 17 November 2002</center>
<p>
<center>
@@ -47,45 +47,68 @@
<a name="contents"></a>
<h2>Contents of this manual</h2>
-<h4>1 <a href="#intro">Introduction</a></h4>
- 1.1 <a href="#whatfor">What Valgrind is for</a><br>
- 1.2 <a href="#whatdoes">What it does with your program</a>
+<h4>1 <a href="coregrind_intro.html#intro">Introduction</a></h4>
+ 1.1 <a href="coregrind_intro.html#intro-overview">
+ An overview of Valgrind</a><br>
+ 1.2 <a href="coregrind_intro.html#intro-navigation">
+ How to navigate this manual</a>
+ <br>
+ 1.2.1 <a href="coregrind_intro.html#intro-migrating">
+ For users migrating from valgrind-1.0.X</a>
-<h4>2 <a href="#howtouse">How to use it, and how to make sense
- of the results</a></h4>
- 2.1 <a href="#starta">Getting started</a><br>
- 2.2 <a href="#comment">The commentary</a><br>
- 2.3 <a href="#report">Reporting of errors</a><br>
- 2.4 <a href="#suppress">Suppressing errors</a><br>
- 2.5 <a href="#flags">Command-line flags</a><br>
- 2.6 <a href="#errormsgs">Explaination of error messages</a><br>
- 2.7 <a href="#suppfiles">Writing suppressions files</a><br>
- 2.8 <a href="#clientreq">The Client Request mechanism</a><br>
- 2.9 <a href="#pthreads">Support for POSIX pthreads</a><br>
- 2.10 <a href="#install">Building and installing</a><br>
- 2.11 <a href="#problems">If you have problems</a><br>
+<h4>2 <a href="coregrind_core.html#core">
+ Using and understanding the Valgrind core services
+ </a></h4>
+ 2.1 <a href="coregrind_core.html#core-whatdoes">
+ What it does with your program</a><br>
+ 2.2 <a href="coregrind_core.html#started">
+ Getting started</a><br>
+ 2.3 <a href="coregrind_core.html#comment">
+ The commentary</a><br>
+ 2.4 <a href="coregrind_core.html#report">
+ Reporting of errors</a><br>
+ 2.5 <a href="coregrind_core.html#suppress">
+ Suppressing errors</a><br>
+ 2.6 <a href="coregrind_core.html#flags">
+ Command-line flags for the Valgrind code</a><br>
+ 2.7 <a href="coregrind_core.html#clientreq">
+ The Client Request mechanism</a><br>
+ 2.8 <a href="coregrind_core.html#pthreads">
+ Support for POSIX pthreads</a><br>
+ 2.9 <a href="coregrind_core.html#signals">
+ Handling of signals</a><br>
+ 2.10 <a href="coregrind_core.html#install">
+ Building and installing</a><br>
+ 2.11 <a href="coregrind_core.html#problems">
+ If you have problems</a><br>
+ 2.12 <a href="coregrind_core.html#limits">
+ Limitations</a><br>
+ 2.13 <a href="coregrind_core.html#howworks">
+ How it works -- a rough overview</a><br>
+ 2.14 <a href="coregrind_core.html#example">
+ An example run</a><br>
-<h4>3 <a href="#machine">Details of the checking machinery</a></h4>
- 3.1 <a href="#vvalue">Valid-value (V) bits</a><br>
- 3.2 <a href="#vaddress">Valid-address (A) bits</a><br>
- 3.3 <a href="#together">Putting it all together</a><br>
- 3.4 <a href="#signals">Signals</a><br>
- 3.5 <a href="#leaks">Memory leak detection</a><br>
+<h4>3 <a href="mc_main.html#mc-top">
+ Memcheck: a heavyweight memory checker</a></h4>
-<h4>4 <a href="#limits">Limitations</a></h4>
+<h4>4 <a href="cg_main.html#cg-top">
+ Cachegrind: a cache-miss profiler</a></h4>
-<h4>5 <a href="#howitworks">How it works -- a rough overview</a></h4>
- 5.1 <a href="#startb">Getting started</a><br>
- 5.2 <a href="#engine">The translation/instrumentation engine</a><br>
- 5.3 <a href="#track">Tracking the status of memory</a><br>
- 5.4 <a href="#sys_calls">System calls</a><br>
- 5.5 <a href="#sys_signals">Signals</a><br>
+<h4>5 <a href="ac_main.html#ac-top">
+ Addrcheck: a lightweight memory checker</a></h4>
-<h4>6 <a href="#example">An example</a></h4>
+<h4>6 <a href="hg_main.html#hg-top">
+ Helgrind: a data-race detector</a></h4>
-<h4>7 <a href="#cache">Cache profiling</a></h4>
+The following are not part of the user manual. They describe internal
+details of how Valgrind works. Reading them may rot your mind. You
+have been warned.
-<h4>8 <a href="techdocs.html">The design and implementation of Valgrind</a></h4>
+<h4>7 <a href="mc_techdocs.html#mc-techdocs">
+ The design and implementation of Valgrind</a></h4>
+
+<h4>8 <a href="cg_techdocs.html#cg-techdocs">
+ How Cachegrind works</a></h4>
<hr width="100%">