Re: [Boost-docs] Strange failure to build Quickbook, Doxygen and Autoindex and specialization std::numeric_limits

Subject: Re: [Boost-docs] Strange failure to build Quickbook, Doxygen and Autoindex and specialization std::numeric_limits
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2015-03-12 10:16:50

> -----Original Message-----
> From: Boost-docs [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Raffi Enficiaud
> Sent: 11 March 2015 16:54
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] Strange failure to build Quickbook, Doxygen and Autoindex and
specialization std::numeric_limits

> > On 11 Mar 2015, at 17:47, Paul A. Bristow <pbristow_at_[hidden]> wrote:
> >
> > Short version:
> >
> > I have been building a prototype documentation for a fixed-point
> > library using Quickbook, Doxygen and Autoindex enabled . It includes a specialization of
> std::numeric_limits.
> >
> > It fails to build, but only if it includes a specialization of
> > std::numeric_limits *and* index enabled.
> >
> > The most helpful message is from Doxygen:
> >
> > "
> > error: Cannot open file
> > I:/modular-boost/bin.v2/libs/fixed_point/doc/msvc-12.0/debug/auto-inde
> > x-internal-on/auto-index-verbo
> > se-on/auto-index-on/threading-multi/autodoc-xml/classstd_1_1numeric__l
> > imits_3_01boost_1_1math_1_1
> > fixed__point_1_1negatable_3_01range_00_01resolu7207871e2843a3ccd659eb78939f39a6.xml for
> writing!
> > "
> 
> It looks like the file names are too long. Maybe you can use SHORT_NAMES = YES in the doxygen
configuration.

> Raffi
> 
> http://www.stack.nl/~dimitri/doxygen/manual/config.html#cfg_short_names

Right!

b2 with  --hash also works.

Thanks.

Paul

PS The Wild Goose chasing the Red Herring could have been avoided if the error message had been more
explicit - 'could not create file' or 'filename too long'.