Способность IDE интерпретировать ваши докблоки встроена в NetBeans и Eclipse и, возможно, в другие IDE. Это не phpDocumentor работает для вас (но я думаю, близко).
Установка phpDocumentor будет означать возможность генерировать документы API из вашего кода и его блоков документации.