If I have two files:

bar.php:
<?php
/**
 *  Bar description here
 *
 *  .
 *
 *  @addtogroup    bar
 */


and foo.php:
<?php
/**
 * Foo description here
 *
 * @addtogroup    bar
 */



I get a warning:
 foo.php:5: warning: End of list marker found without any preceding list
items

The warning should be on bar.php, not foo.php

The problem as depicted here comes from the fact that the 2 comment blocks
are taken together and processed together as 1 block. When adding a '.' line
to bar.php we get one more message and here the line is pointing to a line
that does not exists.
Similar behavior can be observed when doing this in .h files.

When having the php as well as the h files (see to it that the documentation
in the files is different, otherwise the documentation is filtered out).
All messages point to one file.

A solution of this problem would probably requires some sort of stack of
file names and line numbers and would have implications at a lot of places
in the code.