Heading cleanups + merged introduction and index

git-svn-id: http://www.varnish-cache.org/svn/trunk/varnish-cache@4810 d4fa192b-c00b-0410-8231-f00ffab90ce4

doc/sphinx/tutorial/advanced_backend_servers.rst

 Advanced Backend configuration
-==============================
+------------------------------
 
 At some point you might need Varnish to cache content from several
 servers. You might want Varnish to map all the URL into one single

doc/sphinx/tutorial/increasing_your_hitrate.rst

 .. _tutorial-increasing_your_hitrate:
 
 Achieving a high hitrate
-========================
+------------------------
 
 Now that Varnish is up and running, and you can access your web
 application through Varnish. Unless your application is specifically
@@ -60,6 +60,7 @@ There are also a couple of great plugins for Firefox. Both *Live HTTP
 Headers* and *Firebug* can show you what headers are beeing sent and
 recieved.
 
+
 HTTP Headers
 ------------
 

doc/sphinx/tutorial/index.rst

@@ -4,9 +4,24 @@
 Varnish Tutorial
 %%%%%%%%%%%%%%%%
 
-.. toctree::
+Varnish is a web accelerator. It is installed in frond of your web
+application and it caches the reponses, making your web site run  Varnish
+is fast, flexible and easy to use.
+
+This tutorial does not go through every bit of functionality Varnish
+has. It will give you a good overview of what Varnish does and how it
+is done.
+
+We assume you have a web server and a web application up and running
+and that you want to accelerate this application with Varnish.
+
+Furthermore we assume you have read the :ref:`Installation` and that
+it is installed with the default configuration.
+
+
+
+.. toctree:: 
 
-	intro.rst
 	backend_servers.rst
         starting_varnish.rst
 	logging.rst

doc/sphinx/tutorial/intro.rst

-%%%%%%%%%%%%
-Introduction
-%%%%%%%%%%%%
-
-Varnish is a web accelerator. It is installed in frond of your web
-application and it caches the reponses, making your web site run  Varnish
-is fast, flexible and easy to use.
-
-This tutorial does not go through every bit of functionality Varnish
-has. It will give you a good overview of what Varnish does and how it
-is done.
-
-We assume you have a web server and a web application up and running
-and that you want to accelerate this application with Varnish.
-
-Furthermore we assume you have read the :ref:`Installation` and that
-it is installed with the default configuration.
-
-
-
-

doc/sphinx/tutorial/statistics.rst

@@ -8,7 +8,7 @@ Now that your varnish is up and running lets have a look at how it is
 doing. There are several tools that can help.
 
 varnishtop
-==========
+~~~~~~~~~~
 
 The varnishtop utility reads the shared memory logs and presents a
 continuously updated list of the most commonly occurring log entries.
@@ -24,7 +24,7 @@ Accept-Encoding`` will show the most popular Accept-Encoding header
 the client are sendning you.
 
 varnishhist
-===========
+~~~~~~~~~~~
 
 The varnishhist utility reads varnishd(1) shared memory logs and
 presents a continuously updated histogram showing the distribution of
@@ -35,7 +35,7 @@ and misses are marked with a hash character ("#").
 
 
 varnishsizes
-============
+~~~~~~~~~~~~
 
 Varnishsizes does the same as varnishhist, except it shows the size of
 the objects and not the time take to complete the request. This gives
@@ -43,7 +43,7 @@ you a good overview of how big the objects you are serving are.
 
 
 varnishstat
-===========
+~~~~~~~~~~~
 
 Varnish has lots of counters. We count misses, hits, information about
 the storage, threads created, deleted objects. Just about

doc/sphinx/tutorial/troubleshooting.rst

 Troubleshooting Varnish
-=======================
+-----------------------
 
 
 When Varnish won't start
-------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 Sometimes Varnish wont start. There is a pletphora of reasons why
 Varnish wont start on your machine. We've seen everything from wrong
@@ -45,6 +45,6 @@ of Varnish.
 
 
 Varnish is crashing
--------------------
+~~~~~~~~~~~~~~~~~~~
 
 When varnish goes bust.

doc/sphinx/tutorial/vcl.rst

 Varnish Configuration Language - VCL
-====================================
-
-How ordinary configuration files work
 -------------------------------------
 
 Varnish has a really neat configuration system. Most other systems use
@@ -27,9 +24,6 @@ lets point out a few weaknesses with this model.
    the first? Or does Squid try to combine all the matching rules. I
    actually don't know. 
 
-Enter VCL
----------
-
 Now enter Varnish. Varnish takes your configuration file and
 translates it to C code, then runs it through a compiler and loads
 it. When requests come along varnish just executes the relevant