Debian Bug report logs - #544966
doxygen-3.6.1 creates html/search; may be worth NEWS?

Reply or subscribe to this bug.

Display info messages

Message #5 received at [email protected] (full text, mbox, reply):

From: Daniel Schepler <[email protected]>

To: [email protected]

Subject: icu: FTBFS: Unexpected character `"'

Date: Wed, 2 Sep 2009 16:35:49 -0700

Package: icu
Version: 4.2.1-2
Severity: serious

From my pbuilder build log:

...
/usr/bin/make -C /tmp/buildd/icu-4.2.1/source install-doc DESTDIR=/tmp/buildd/icu-4.2.1/debian/tmp
make[1]: Entering directory `/tmp/buildd/icu-4.2.1/source'
CONFIG_FILES=Doxyfile CONFIG_HEADERS= /bin/sh ./config.status
config.status: creating Doxyfile
/usr/bin/doxygen
Warning: Tag `USE_WINDOWS_ENCODING' at line 16 of file Doxyfile has become obsolete.
To avoid this warning please update your configuration file using "doxygen -u"
Warning: Tag `DETAILS_AT_TOP' at line 28 of file Doxyfile has become obsolete.
To avoid this warning please update your configuration file using "doxygen -u"
Warning: Tag `MAX_DOT_GRAPH_WIDTH' at line 222 of file Doxyfile has become obsolete.
To avoid this warning please update your configuration file using "doxygen -u"
Warning: Tag `MAX_DOT_GRAPH_HEIGHT' at line 223 of file Doxyfile has become obsolete.
To avoid this warning please update your configuration file using "doxygen -u"
Notice: Output directory `doc' does not exist. I have created it for you.
Searching for include files...
Searching for example files...
Searching for images...
Searching for dot files...
Searching for files to exclude
Searching for files to process...
Searching for files in directory /tmp/buildd/icu-4.2.1/source/common/unicode
Searching for files in directory /tmp/buildd/icu-4.2.1/source/i18n/unicode
Searching for files in directory /tmp/buildd/icu-4.2.1/source/io/unicode
Searching for files in directory /tmp/buildd/icu-4.2.1/source/layoutex/layout
Reading and parsing tag files
Preprocessing /tmp/buildd/icu-4.2.1/source/common/unicode/platform.h...
Parsing file /tmp/buildd/icu-4.2.1/source/common/unicode/platform.h...
Preprocessing /tmp/buildd/icu-4.2.1/source/common/unicode/brkiter.h...
Parsing file /tmp/buildd/icu-4.2.1/source/common/unicode/brkiter.h...
...
Generating docs for file fieldpos.h...
Generating docs for file fmt/tmp/buildd/icu-4.2.1/source/common/unicode/platform.h:62: Warning: Unsupported xml/html tag <string> found
/tmp/buildd/icu-4.2.1/source/common/unicode/platform.h:62: Warning: Unsupported xml/html tag <string> found
/tmp/buildd/icu-4.2.1/source/common/unicode/std_string.h:20: Warning: Unsupported xml/html tag <string> found
/tmp/buildd/icu-4.2.1/source/common/unicode/std_string.h:20: Warning: Unsupported xml/html tag <string> found
/tmp/buildd/icu-4.2.1/source/common/unicode/ubidi.h:795: Error: Unexpected character `"'
/tmp/buildd/icu-4.2.1/source/common/unicode/ubrk.h:78: Error: Unexpected character `"'
/tmp/buildd/icu-4.2.1/source/common/unicode/uchar.h:375: Error: Unexpected character `"'
/tmp/buildd/icu-4.2.1/source/common/unicode/uidna.h:78: Error: Unexpected character `"'
/tmp/buildd/icu-4.2.1/source/common/unicode/uidna.h:125: Error: Unexpected character `"'
/tmp/buildd/icu-4.2.1/source/io/unicode/ustdio.h:370: Error: Unexpected character `"'
/tmp/buildd/icu-4.2.1/source/common/unicode/ustring.h:919: Warning: explicit link request to 'define' could not be resolved
/tmp/buildd/icu-4.2.1/source/common/unicode/ustring.h:923: Warning: explicit link request to 'define' could not be resolved
/tmp/buildd/icu-4.2.1/source/common/unicode/ustring.h:968: Error: Unexpected character `"'
able.h...
...
Generating namespace index...
Generating namespace member index...
Generating graph info page...
Generating file index...
Generating example index...
Generating file member index...
rm -f -r /tmp/buildd/icu-4.2.1/debian/tmp/usr/share/doc/icu/html
/bin/sh ./mkinstalldirs /tmp/buildd/icu-4.2.1/debian/tmp/usr/share/doc/icu/html
mkdir /tmp/buildd/icu-4.2.1/debian/tmp/usr/share/doc
mkdir /tmp/buildd/icu-4.2.1/debian/tmp/usr/share/doc/icu
mkdir /tmp/buildd/icu-4.2.1/debian/tmp/usr/share/doc/icu/html
/usr/bin/install -c -m 644 doc/html/* /tmp/buildd/icu-4.2.1/debian/tmp/usr/share/doc/icu/html
/usr/bin/install: omitting directory `doc/html/search'
make[1]: *** [install-doc] Error 1
make[1]: Leaving directory `/tmp/buildd/icu-4.2.1/source'
make: *** [install/icu-doc] Error 2
dpkg-buildpackage: error: fakeroot debian/rules binary gave error exit status 2

(This was with doxygen version 1.6.1-1.)
-- 
Daniel Schepler

Message #10 received at [email protected] (full text, mbox, reply):

From: Jay Berkenbilt <[email protected]>

To: Daniel Schepler <[email protected]>

Cc: [email protected]

Subject: Re: Bug#544799: icu: FTBFS: Unexpected character `"'

Date: Thu, 03 Sep 2009 18:12:42 -0400

Daniel Schepler <[email protected]> wrote:

> /tmp/buildd/icu-4.2.1/source/common/unicode/ubidi.h:795: Error: Unexpected character `"'
> /tmp/buildd/icu-4.2.1/source/common/unicode/ubrk.h:78: Error: Unexpected character `"'
> . . .

Are we sure this is an ICU problem and not a doxygen problem?  At a
glance, I don't see how the "'s that appear in the doxygen comments are
problematic.  I'm going to look into it a bit more, but as doxygen 1.6.1
is on day 8 of 10, I need to decide fast whether to reassign the box to
doxygen.

-- 
Jay Berkenbilt <[email protected]>

Message #15 received at [email protected] (full text, mbox, reply):

From: Daniel Schepler <[email protected]>

To: Jay Berkenbilt <[email protected]>

Cc: [email protected]

Subject: Re: Bug#544799: icu: FTBFS: Unexpected character `"'

Date: Thu, 3 Sep 2009 15:26:47 -0700

On Thursday 03 September 2009 15:12:42 Jay Berkenbilt wrote:
> Daniel Schepler <[email protected]> wrote:
> > /tmp/buildd/icu-4.2.1/source/common/unicode/ubidi.h:795: Error:
> > Unexpected character `"'
> > /tmp/buildd/icu-4.2.1/source/common/unicode/ubrk.h:78: Error: Unexpected
> > character `"' . . .
> 
> Are we sure this is an ICU problem and not a doxygen problem?  At a
> glance, I don't see how the "'s that appear in the doxygen comments are
> problematic.  I'm going to look into it a bit more, but as doxygen 1.6.1
> is on day 8 of 10, I need to decide fast whether to reassign the box to
> doxygen.

I'm not sure.  The errors I looked at were with lines something like:
  \\" => U0022
If you replace that with \\\" and escape the other quotes similarly, does that 
fix the errors?  (I don't know much about doxygen myself, so that's just a 
blind guess.)
-- 
Daniel Schepler

Message #26 received at [email protected] (full text, mbox, reply):

From: Jay Berkenbilt <[email protected]>

To: [email protected]

Subject: more information about Unexpected character `"'

Date: Fri, 04 Sep 2009 09:55:14 -0400

The ICU package received this bug report about failing to build because
of doxygen errors.  I looked at the files in question, and couldn't see
anything obvious that should have triggered this error.  I also see from
the doxygen website that 3.6.1 included some fixes to other bugs
relating to this same error message.

At this point, I have yet to determine whether this is actually a
doxygen problem or whether it's a genuine ICU problem that doxygen is
only now picking up on, or whether the doxygen errors are a red herring
and there's something else broken with the ICU build.  What I am certain
about, however, is that ICU builds properly with doxygen 3.5.9 but fails
to build with 3.6.1.

Since doxygen 3.6.1 was on day 8 of 10 before making the jump to squeeze
and the introduction of 3.6.1 causes ICU to FTBFS, I thought I'd better
act quickly in creating this (RC) bug even before being 100% certain
that it is a doxygen problem.  I will spend a little bit of time this
weekend tracking it down further and trying to reproduce it in a small
test case.  When I do, I will update this bug.  If you discover in the
mean time that it is fact a doxygen bug, feel free to take appropriate
action.  The ICU bug corresponding to this one is 544799.  Thanks.

-- 
Jay Berkenbilt <[email protected]>

Message #31 received at [email protected] (full text, mbox, reply):

From: Jay Berkenbilt <[email protected]>

To: [email protected], [email protected]

Subject: probably not doxygen

Date: Fri, 04 Sep 2009 11:22:07 -0400

Maybe doxygen 3.6.1 is creating the search directory so ICU's install
statement is too general.  I think the `"' is a red herring and is not
related to this bug.  More details soon.

Message #36 received at [email protected] (full text, mbox, reply):

From: Jay Berkenbilt <[email protected]>

To: [email protected]

Cc: [email protected]

Subject: downgrading bug

Date: Fri, 04 Sep 2009 11:42:03 -0400

retitle 544966 doxygen-3.6.1 creates html/search; may be worth NEWS?
severity 544966 important
thanks

Never mind...I found the problem.  doxygen 3.6.1 is now creating a
search directory under the html output directory.  Programs such as ICU
that do "install html/* dest" in their install steps will now fail to
install because install will complain about skipping the search
directory.

This is likely to cause other packages to fail to build from source as
well, so it may be worth a note in the debian/NEWS file.

-- 
Jay Berkenbilt <[email protected]>

Send a report that this bug log contains spam.