Adding HTML example

doc/Makefile

@@ -33,4 +33,4 @@ outputs:
 
 clean:
 	- \rm -f guide.xml
-	- \rm -f examples/.*.py examples/.*.h examples/.*.cpp examples/.*.sh examples/runner examples/TEST*.xml examples/parsetab.py examples/*.orig examples/runner.cpp
+	- \rm -f examples/.*.py examples/.*.h examples/.*.cpp examples/.*.sh examples/runner examples/TEST*.xml examples/parsetab.py examples/*.orig examples/runner.cpp examples/*.html

doc/examples/example4.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+
+. GetGlobals.sh
+export PATH=$CXXTEST/bin:$PATH:`pwd`/../../scripts
+
+cd example1
+ROOT=`pwd`
+
+# @compile:
+g++ -fprofile-arcs -ftest-coverage -fPIC -O0 example1.cpp -o program
+# @:compile
+
+# @run:
+./program
+# @:run
+
+# @gcovr:
+gcovr -r . --html -o example1.html
+# @:gcovr
+mv example1.html ..
+
+\rm -f program *.gc*

doc/guide.txt

@@ -76,7 +76,7 @@ statistics when deciding if software is ready for a release.
 The +gcovr+ command can be used to analyze programs compiled with
 GCC.   The following sections illustrate the application of +gcovr+
 to test coverage of the following program:
-
+[source,cpp,numbered]
 ----
 include::examples/example1/example1.cpp[]
 ----
@@ -186,6 +186,21 @@ used to support performance optimization in the same manner that
 +gcov+ does.
 
 
+HTML Output
+~~~~~~~~~~~
+
+The +gcovr+ command can also generate a simple
+HTML output using the +--html+ option:
+[source,bash]
+----
+include::examples/.example4_gcovr.sh[]
+----
+This generates a HTML summary of the lines executed.  In this example, the file +example1.html+ is generated, which has the following output:
+
+image::examples/example1.png[align="center"]
+
+
+
 [[gcovrCommand]]
 The +gcovr+ Command
 -----------------