Если вы уже задокументировали свои элементы кода с помощью docblocks, то когда вы используете эти элементы в вашем коде, функция всплывающих всплывающих окон Eclipse действительно покажет вам, что находится в их docblocks. Для этого не требуется открывать другой файл, например, писать код в test.php, который использует класс Foo из foo.php ... вам не нужно открывать foo.php в редакторе, чтобы у вашего объекта Foo в test.php была видимая всплывающая информация о блокировке всплывающих окон.
Если такие всплывающие окна не показывают вам информацию о блоке документации, вам, возможно, придется пересмотреть настройки buildpath / includepath в вашем проекте PHP, особенно если элементы, которые вы пытаетесь использовать, фактически определены в другом проекте чем тот, в котором вы работаете.