[Buildbot-devel] HTML docs

Sun Jun 19 22:13:46 UTC 2005

> [see the <style> section which turns into a big comment which  
> envelops the whole table of contents. ???]

Wacky. There are 5 lines present in my output that aren't in yours:

> <meta http-equiv="Content-Style-Type" content="text/css">
> <style type="text/css"><!--
>    pre.display { font-family:inherit }
>    pre.format  { font-family:inherit }
>    pre.smalldisplay { font-family:inherit; font-size:smaller }
>    pre.smallformat  { font-family:inherit; font-size:smaller }
>    pre.smallexample { font-size:smaller }
>    pre.smalllisp    { font-size:smaller }
>    span.sc { font-variant:small-caps }
>    span.roman { font-family: serif; font-weight<div class="contents">

--></style>
</head>
<body>
<h1 class="settitle">BuildBot Manual 1.0</h1>
<div class="contents">

> <h2>Table of Contents</h2>
> <ul>

etc..

I get those lines with the buildbot.texinfo that's in 0.6.6, the one in
current CVS, and the one in my local-usebranches tree (after commenting out
the missing overview.jpg image, of course), all with makeinfo 4.7 from debian
'sid'. I assume you've deleted the buildbot/ tree from the failed makeinfo to
let it re-generate index.html.. I have no idea if it will replace an existing
one or not.

And we're both running verison 4.7 of makeinfo. Weird. You're doing this on
OS-X? Maybe there's some platform-specific bug.. My Panther system has
makeinfo 4.6, and it complains:

 14:warner at quartz% makeinfo --html buildbot.texinfo 
 /Users/warner/stuff/python/buildbot-0.6.6/docs/buildbot/index.html: TOC should be here, but it was not found
 makeinfo: Removing output file `/Users/warner/stuff/python/buildbot-0.6.6/docs/buildbot/index.html' due to errors; use --force to preserve.

Maybe there's a .texinfo TOC section that should be present, but isn't, and
the non-OS-X versions of 4.7 can cope, the OS-X version of 4.7 fails
silently, and all versions of 4.6 bail with an error?

I'll poke around to see if there's some kind of TOC directive I'm missing.

wacky,
 -Brian