Tach!
Und nun? Hat einer eine Idee?
Schreib den Kommentar über die Variable/Eigenschaft/wasauchimmer. So ein Kommentar, der weitab von dem zu kommentierenden Objekt steht, ist schwerer zuzuordnen als einer, der direkt darüber oder darunter steht.
Die Form, so wie du sie anstrebst, bildet optisch gesehen links einen Block und rechts einen. Die Zugehörigkeiten sind stattdessen aber zeilenweise. Wenn du das hingegen so formatierst:
//Diese Variable beinhaltet...
public $test;
//Diese Variable beinhaltet...
public $nochntest;
bilden sich Blöcke, die die Zugehörigkeiten besser zeigen. Und noch besser wäre, wenn du die PHPDoc-Syntax verwenden würdest, dann können IDEs, die diese verstehen (Eclipse gehört dazu), direkt beim Tippen helfen, indem sie die Kommentare als Tooltip einblenden. Ansonsten musst du, um selbige lesen zu können erst zur Definitionsstelle springen.
/**
* @var string Diese Variable beinhaltet...
*/
public $test;
/**
* @var int Diese Variable beinhaltet...
*/
public $nochntest;
dedlfix.