POS is very good because is easy and fast to do (KISS), not more hard than a comment. And you can convert it to any format, and have good looks too.
I don't like for example the JavaDoc style, that you can see in java.sun.com. I think that Java has many things to learn with Perl. For example, to understand how a class work in Perl is very easy, but in JavaDocs you need to open a lot of pages. Java always think in OO, but the docs don't help much the OO idea.
Graciliano M. P.
"The creativity is the expression of the liberty".