In response to Stefano Locati's "How to Document Your PHP classes", I created a quick & simple PHP script which will parse other PHP3 files and create some basic documentation. The advantage to this is, it can be placed under any comment -- plus it's very extendable.
The current scripts recognises these commands:
@@ = Header
%% = Description
!! = Horizontal Line
; = End of decleration.
%%This function takes 2 variables and does absolutely nothing with them.;
Would produce something like this:
Description: This function takes 2 variables and does absolutely nothing with them.
(horizontal line here)