[EMAIL PROTECTED] wrote:
Automated build for cocoon-docs FAILED
Log attached.
Since this is the first time one of these appeared on the list I am
going to document the debug process here:
First scan the output log for a broken page:
<snip/>
Cocoon will report the status of each document:
- in column 1: *=okay X=brokenLink ^=pageSkipped (see FAQ).
So we are looking for an X in most cases:
[java] ------------------------------------------------------------------------
[java] cocoon 2.2.0-dev
[java] Copyright (c) 1999-2005 Apache Software Foundation. All rights
reserved.
[java] Build: September 19 2005 (TargetVM=1.4, SourceVM=1.3, Debug=on,
Optimize=on)
[java] ------------------------------------------------------------------------
[java]
[java]
[java] ^ 2.1/
[java] * [1/297] [297/298] 4.942s 91.4Kb linkmap.html
[java] * [2/306] [10/302] 1.688s 61.1Kb 2.1/581.daisy.html
[java] * [3/305] [0/294] 0.94s 42.4Kb 2.1/482.daisy.html
<snip/>
[java] * [177/165] [0/296] 0.85s 42.4Kb 2.1/477.daisy.html
[java] * [178/164] [0/292] 0.989s 42.9Kb 2.1/709.daisy.html
[java] * [179/163] [0/293] 0.904s 44.9Kb 2.1/438.daisy.html
[java] X [0]
snippet/snippet-xslt-options.html BROKEN:
/export/home/config/forrestbot-trunk/conf/work/cocoon-docs/src/documentation/content/xdocs/snippet/snippet-xslt-options.xml
(No such file or directory)
[java] * [181/161] [0/292] 0.997s 40.3Kb 2.1/551.daisy.html
[java] * [182/160] [0/294] 0.858s 42.6Kb 2.1/424.daisy.html
<snip/>
[java] * [377/50] [0/297] 1.15s 46.1Kb 2.1/515.daisy.html
[java] * [378/50] [1/295] 0.819s 41.8Kb 2.1/712.daisy.html
[java] X [0]
tutorial/tutorial-rmi-generator.html BROKEN:
/export/home/config/forrestbot-trunk/conf/work/cocoon-docs/src/documentation/content/xdocs/tutorial/tutorial-rmi-generator.xml
(No such file or directory)
[java] * [380/48] [0/293] 0.941s 39.2Kb 460.daisy.html
So there are at least a couple of problems.
Now go to
http://forrest.zones.apache.org/ft/build/cocoon-docs/broken-links.xml
(actually you can usually come straight here)
That page shows:
<broken-links>
<link
message="/export/home/config/forrestbot-trunk/conf/work/cocoon-docs/src/documentation/content/xdocs/snippet/snippet-xslt-options.xml
(No such file or directory)" uri="snippet/snippet-xslt-options.html">
<referrer uri="2.1/711.daisy.html"/>
</link>
<link
message="/export/home/config/forrestbot-trunk/conf/work/cocoon-docs/src/documentation/content/xdocs/tutorial/tutorial-rmi-generator.xml
(No such file or directory)" uri="tutorial/tutorial-rmi-generator.html">
<referrer uri="2.1/712.daisy.html"/>
</link>
</broken-links>
Now we see the problems are on pages 711 and 712 in daisy and are, as
suspected, bad links.
Now go to daisy and look at the first page (711), you can go straight to
a page by entering:
http://cocoon.zones.apache.org/daisy/legacydocs/{PAGE_NUMBER}
so, http://cocoon.zones.apache.org/daisy/legacydocs/711
takes us to the page we want.
Now look for the offending link and fix it (you know how this is done ;-)
(I'll fix these two breaks now)
Ross
