The following is as far as I can tell incorrectly reporting:

FILE: .../ooe/ooe.module
----------------------------------------------------------------------
FOUND 1 ERROR AFFECTING 1 LINE
----------------------------------------------------------------------
 22 | ERROR | [x] Separate the @file and @link sections by a blank line.
----------------------------------------------------------------------

/**
 * @file
 * The non-OO module hook file for the Object-Oriented Examples (OOE) project.
 *
 * An educational tutorial module that demonstrates an Object-Oriented
 * bridge between Drupal7 core's contributed module API and a fully
 * Object-Oriented space. OOE stands for Object-Oriented Examples.
 *
 * OOE also progressively demonstrates "one of each" (OOE) of the
 * capabilities of Drupal contributed modules using object-oriented PHP
 * and the special bridge between Drupal core and a full OO coding space.
 *
 * OOE may also be taken to mean "Object Oriented Examples",
 * because it demonstrates object-oriented techniques and promotes
 * a move towards true object-orientation in future Drupal,
 * and already offers a form of pure OO module development API.
 *
 * A comprehensive guide with OOE running live and a detailed discussion
 * with links to many object-oriented examples is available at:
 * @link http://drupal7demo.webel.com.au/module/ooe Webel Drupal7 demo: OOE @endlink.
 *
 * ...

Comments

webel’s picture

Another similar example. This causes Coder 8.x-2.x-dev to trip with:

 Separate the @todo and @link sections by a blank line.
/**
 * Abstract implementation of those parts of a block view
 * typically common to all implementations.
 *
 * @todo Consider forcing use of @link IRender @endlink objects
 * instead of permitting any render array return values.
 *
 * UML:
 * @link http://drupal7demo.webel.com.au/node/1128 AbstractBlockView @endlink.
 */

But placing the @todo lower in the docblock prevents the error report:

/**
 * Abstract implementation of those parts of a block view
 * typically common to all implementations.
 *
 * UML:
 * @link http://drupal7demo.webel.com.au/node/1128 AbstractBlockView @endlink.
 *
 * @todo Consider forcing use of @link IRender @endlink objects
 * instead of permitting any render array return values.
 */
klausi’s picture

Status: Active » Fixed

Committed a fix, thanks for reporting!

  • klausi committed 5e0a16e on 8.x-2.x
    Issue #2465729: Incorrect report 'Separate the @file and @link sections...
webel’s picture

@klausi Confiming fix OK, thanks, Webel

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.