We write the Free Pascal documentation with FPDoc. The biggest difference with Pasdoc is that FPDoc builds the documentation using a combination of source code and documentation files, while Pasdoc reads documentation from comments.

The FPDoc approach has turned out to be supperior for us, because if you put all the documentation in comments ultimately it gets "in the way" , because the documentation is very verbose.