The format we've been using is single line for phpBB classes and more (to include a description) for other variables.

/** @var \phpbb\... */

/**
* Board Rules Table Name
*
* Name of the database table the rule will be stored in
*
* @var string
*/