On Mon, 2008-01-07 at 19:40 +0100, Timm Preetz wrote:
> since 4.0.5 it should be possible to build the docs with graphics, but
> that doesn't work here.
>=20
> Is there any (hidden) option I have to trigger besides "make doc"?
Nothing hidden, but it's not hooked up to anything yet. You're looking
for Harness in tests/screenshots/. Sorry, I thought I mentioned that
somewhere. Either run it from Eclipse, or from the command line
something like=20
/opt/sun-jdk-1.5.0.13/bin/java -client \
-classpath tmp/tests:tmp/gtk-4.0.jar \
-Djava.library.path=3Dtmp \
-ea
Harness
=20
ought to do it.
It's not hooked up to `make doc` yet partially because I've been meaning
to move that target to build/faster and haven't gotten around to it, but
mostly because it's not *that* reliable yet. Lots of paths are hard
coded, that sort of thing. And the whole Xvfb invocation is *really*
fragile. Fixing all that is going to take a lot of work, and I have more
important things to do.
We should add it, but I'm not sure I want to deal with bugs from people
complaining `make doc` doesn't work for them. The thing _is_ a rather
ugly hack still.
[It's also rather slow, so for now I don't really want `make doc`
blocking on it. What would be really cool would be a javadoc doclet that
didn't generate crap output when run incrementally. Then it could be
driven by the build engine and only those .html and .png files actually
needed could be done as necessary]
> In related news: Is it normal to get _very_ much output in the form of
> warning that packages don't exist or "Tag @link: can't find modifyXYZ"?
Yes, although obviously we want the list to drop to zero over time.
Contributions to add the coverage so that those dangling cross
references are resolved would, of course, be more than welcome.
Still, better to have the links to things that we know are going to be
there "soon" than not having the cross references at all and never
thinking to add them in the future.
AfC
Sydney
|
