--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mpdot/doc/Demo_the_linkchecker.txt	Fri Apr 23 20:45:58 2010 +0100
@@ -0,0 +1,79 @@
+Demoing the link checker.
+=========================
+
+Before the demo
+---------------
+
+The linkcheck executable is at:
+C:\apps\ditaot\DITA-OT1.5.1\python\dist\linkcheck.exe
+
+Fire up a shell and add to the path
+C:\> set PATH=C:\apps\ditaot\DITA-OT1.5.1\python\dist;%PATH%
+
+Navigate to a build, here I have assumed that a subst has been done, e.g.
+
+C:\>subst S: E:\hydra\201006All
+
+Move there:
+C:\>S:
+
+S:\>
+
+During the demo
+---------------
+Show the knind of things that linkcheck does
+S:\>linkcheck -?
+This lists the errors that we check for and the options that it can take.
+
+[
+Optionally can show off running lincheck unit tests but this will probably hang on the servers as they have no internet access:
+S:\>linkcheck -u -l30
+]
+
+
+Try it on raw Doxygen output:
+S:\>cd S:\epoc32\build\esockserver\c_2a28510674fa652b\
+
+S:\epoc32\build\esockserver\c_2a28510674fa652b>linkcheck esocksvr_dll\dox\dita
+Should get something like:
+
+CMD: linkcheck esocksvr_dll\dox\dita
+2010-03-16 11:46:19,561 INFO     DitaFileSet starting to read...
+2010-03-16 11:46:24,108 INFO     DitaFileSet.finalise() start...
+2010-03-16 11:46:27,372 INFO     DitaFileSet.finalise() done.
+================================ Statistics ===============================
+                Maps:          1 [     0.000 M]
+            Non-maps:       1670 [     0.002 M]
+               Files:       1671 [     0.002 M]
+               Bytes:   31033697 [    29.596 M]
+                 IDs:      19636 [     0.019 M]
+                Refs:      37142 [     0.035 M]
+           Read time:      4.543 (s)
+       Analysis time:      3.253 (s)
+===========================================================================
+============================== Error Summary ==============================
+Code      Count Error
+----      ----- -----
+ 410        260 Can not resolve reference to file "..."
+ 411       3195 Can resolve reference to file "..." but not to fragment "..."
+ 505         40 Duplicate id="..." in files: ...
+===========================================================================
+
+Show off multiprocessing:
+S:\epoc32\build\esockserver\c_2a28510674fa652b>linkcheck -j0 esocksvr_dll\dox\dita
+Read time is much faster.
+
+Now process some MODE guide:
+S:\epoc32\build\esockserver\c_2a28510674fa652b>cd \epoc32\release\doxygen\
+Run linkcheck:
+S:\epoc32\release\doxygen>linkcheck -j0 "GUID-27F4B43B-13E2-425C-95B2-87A840AF614B (guide)"
+
+Show deeper analysis of error code 600:
+S:\epoc32\release\doxygen>linkcheck -j0 -e 600 --file=specific "GUID-27F4B43B-13E2-425C-95B2-87A840AF614B (guide)"
+
+
+
+
+
+
+