I think it would be quite useful to generate parts of the apt file from actually running the commands during build/packaging. At least for commands like --help, this would ensure, that the site is always up-to-date.
Good idea. I think the snippet macro is a way to archive this.
http://maven.apache.org/doxia/macros/
Using something like: