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)"