From jy6y13 at soton.ac.uk  Wed Nov 22 11:15:32 2017
From: jy6y13 at soton.ac.uk (Jiadi Yao)
Date: Wed, 22 Nov 2017 11:15:32 +0000
Subject: Documentation page down
Message-ID: <81440a83-52d5-70ba-9c52-9f1107347bb2@soton.ac.uk>

Hi,

Just want to report that the documentation page below returns an empty page:

https://xapian.org/docs/apidoc/html/index.html


Thanks

Jiadi



From olly at survex.com  Fri Nov 24 19:41:02 2017
From: olly at survex.com (Olly Betts)
Date: Fri, 24 Nov 2017 19:41:02 +0000
Subject: Documentation page down
In-Reply-To: <81440a83-52d5-70ba-9c52-9f1107347bb2@soton.ac.uk>
References: <81440a83-52d5-70ba-9c52-9f1107347bb2@soton.ac.uk>
Message-ID: <20171124194102.GK17233@survex.com>

On Wed, Nov 22, 2017 at 11:15:32AM +0000, Jiadi Yao wrote:
> Just want to report that the documentation page below returns an empty page:
> 
> https://xapian.org/docs/apidoc/html/index.html

It looks like the issue is that doxygen now uses Javascript to build its
menus (which seems like a strange choice for a static documentation
generator), but we only package up *.html *.css and *.png.  So I think
this used to work, but was broken a doxygen upgrade.

Just packaging up *.js too wouldn't solve this, as we're using a custom
page header, and that doesn't include the Javascript files, so that
needs fixing too.  Or working out how to configure doxygen to stop
Javascript being needed, if that's possible.

For now, use this link:

https://xapian.org/docs/apidoc/html/annotated.html

That mostly works (a few things seem to now use jquery, like the
expand/contract arrows, so those are non-functioning right now).

Thanks for noticing and reporting.  I'll sort this out soon.

Cheers,
    Olly