Re: [Boost-docs] Failure to build using quickbook doxygen and auto-index?

Subject: Re: [Boost-docs] Failure to build using quickbook doxygen and auto-index?
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-01-12 12:31:45

I have reverted to Doxygen 1.6.1 and confirm that 1.6.1 works OK, but 1.6.2
fails for me for reasons unclear as yet, even after adding

<doxygen:param>SEARCHENGINE=NO

which does prevent the log warning/error "Could not create search results
directory 'html/search/search'"

Build docs log says:

doxygen-action ..\bin.v2\doc\msvc-9.0\debug\threading-multi\autodoc-xml.xml-dir
Could Not Find
I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\bin.v2\doc
\msvc-9.0\debug\threading-multi\autodoc-xml\*.xml

Suggestions on how to find the cause and report to Doxygen support?

Paul

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden]
[mailto:boost-docs-bounces_at_[hidden]]
> On Behalf Of Paul A. Bristow
> Sent: Tuesday, January 12, 2010 10:25 AM
> To: 'Discussion of Boost Documentation'
> Subject: Re: [Boost-docs] Failure to build using quickbook doxygen and
auto-index?
> 
> Linux debian Bug#564338: seems to be a problem of the SEARCH_ENGINE feature of
> doxygen advises adding
> 
>     <doxygen:param>SEARCHENGINE=NO
> 
> to avoid the warning/error.
> 
> Could not create search results directory 'html/search/search'
> 
> See  http://tinyurl.com/yledok9
> 
> This silences the warning/error in the log file, but it still does not build
> (see below) so perhaps I have done something else wrong.
> 
> I have confirmed this  to Bugzilla Bug 606718 -  Could not create search
results
> directory 'html/search/search'
> 
> have anyone else tried re-building the latest Doxygen 1.6.2?
> 
> Paul
> 
> 
> > -----Original Message-----
> > From: boost-docs-bounces_at_[hidden]
> [mailto:boost-docs-bounces_at_[hidden]]
> > On Behalf Of Paul A. Bristow
> > Sent: Monday, January 11, 2010 6:46 PM
> > To: 'Discussion of Boost Documentation'
> > Subject: [Boost-docs] Failure to build using quickbook doxygen and
auto-index?
> >
> > Can anyone give any clues as to what I have messed up to stop previous stuff
> > building?
> >
> > jamfile.v2 contains
> >
> > doxygen autodoc
> >   :
> >     [ glob ../../../boost/quick_auto_dox_index/*.*pp
> >   :
> >     <doxygen:param>WARN_LOGFILE=AutoDoxywarnings.log
> >     <doxygen:param>WARNINGS=YES
> > ;
> >
> > The log file from running the jamfile contains
> >
> > quickbook.quickbook-to-boostbook
> > ..\bin.v2\doc\msvc-9.0\debug\threading-multi\quick_auto_dox_index.xml
> > Generating Output File:
> > ..\bin.v2\doc\msvc-9.0\debug\threading-multi\quick_auto_dox_index.xml
> >
> > doxygen-action
> ..\bin.v2\doc\msvc-9.0\debug\threading-multi\autodoc-xml.xml-dir
> >
> > Could Not Find
> >
> >
>
I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\bin.v2\doc
> > \msvc-9.0\debug\threading-multi\autodoc-xml\*.xml
> >
> > Searching for include files...
> > ...
> >
> > Exiting...
> > xslt-xsltproc
..\bin.v2\doc\msvc-9.0\debug\threading-multi\autodoc-xml.doxygen
> > warning: failed to load external entity
> >
> >
>
"file:///I%3A/boost-sandbox/tools/quick_auto_dox_index/libs/quick_auto_dox_index
> > /bin.v2/doc/msvc-9.0/debug/threading-multi/autodoc-xml/index.xml"
> >
> > unable to parse
> >
>
I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\bin.v2\doc
> > \msvc-9.0\debug\threading-multi\autodoc-xml\index.xml
> >
> >     set XML_CATALOG_FILES=..\bin.v2/boostbook_catalog.xml
> >  "C:\Program Files\xsltproc_win32\xsltproc.exe" --stringparam
doxygen.xml.path
> >
>
"I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\bin.v2\do
> > c\msvc-9.0\debug\threading-multi\autodoc-xml" --xinclude -o
> > "..\bin.v2\doc\msvc-9.0\debug\threading-multi\autodoc-xml.doxygen"
> > "I:\boost_1_41_0\tools\boostbook\xsl\doxygen\collect.xsl"
> >
>
"I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\bin.v2\do
> > c\msvc-9.0\debug\threading-multi\autodoc-xml\index.xml"
> >
> > ...failed xslt-xsltproc
> > ..\bin.v2\doc\msvc-9.0\debug\threading-multi\autodoc-xml.doxygen...
> >
> > Doxygen builds OK using the Doxygen GUI, but the bjam doxygen warnings file
> > contains this text:
> >
> > "Could not create search results directory 'html/search/search'"
> >
> > I presume this comes from Doxygen?  (Incidentally the latest version 1.6.2)
> >
> > However I am puzzled what it means I have done wrong.
> >
> > Suggestions?  Thanks
> >
> > Paul
> >
> > ---
> > Paul A. Bristow
> > Prizet Farmhouse
> > Kendal, UK   LA8 8AB
> > [phone], mobile [phone]
> > pbristow_at_[hidden]