docblox/docblox — Issue #355: File-level docblocks sometimes get ignored
Author: zerocrates
Created: 2012-01-17 22:01:10+00:00
State: open

Given a source file like this:

```php
/**
* @copyright blah blah blah
* @license blah blah blah
*/

/**
* Class short description
*
* @package whatever
*/
class ...
```

DocBlox 0.18.1 complains: "No page-level DocBlock was found in file." The generated documentation doesn't contain license or copyright data for that file.

But, if I simply add a `@package` tag to the file-level docblock, there's no warning, and the data for the file appears as it should.

There's nothing in the DocBlox documentation that leads me to believe the `@package` tag is required anywhere, much less in file-level blocks. For the common one-class-per-file pattern, that extra `@package` tag is at best just a duplication of the class' package, and at worst different but irrelevant.