Created attachment 186984 [details]
Patch to revert regression in parser.

Starting with Release-1.7.1-20100728 (svn -r 738) there is a regression in parsing function return values of type pointer to pointer (or array), e.g.

int *const* test ( ) { return &array; }

In the resulting documentation (html and pdf) one asterisk ("*") is missing.
This worked well in release 1.7.1, and it is still broken in the latest version (svn -r 765).

Here is a short reproducer:
-- snip --
static int *array = 0;
/** This is wrong :-( */
int * const * test1 ( ) { return &array; }
/** This is wrong :-( */
int *const* test1a ( ) { return &array; }
/** This is wrong :-( */
int * * const test2 ( ) { return &array; }
/** This is correct. */
int **  const test3 ( ) { return &array; }
/** This is correct. */
int **  test4 ( ) { return &array; }
/** This is wrong :-( */
int * * test5 ( ) { return &array; }
-- snip --

In the resulting docs, all functions marked with "This is wrong" are missing the second "*". Only test3 and test4 are correct.

I tracked this down to one particular change in svn r 738. Please see attached patch of file src/scanner.l to revert this change and make it work again.

Please note that I don't want to say that this is a correct fix, because I don't know why this change was done in the first place, but I can clearly see that this fixes the issue above.

Thanks for all your work and your attention to this bug report.

Regards
Albrecht