Hi! I hope all of you knows what javadocs are
I was wondering if is there a standar "delphidoc" system.. i've seen some around but they was all "private" things.. is there a standard one ?
I'd like to comment/doc my programs..
JavaDoc rules!
Hi! I hope all of you knows what javadocs are
I was wondering if is there a standar "delphidoc" system.. i've seen some around but they was all "private" things.. is there a standard one ?
I'd like to comment/doc my programs..
JavaDoc rules!
If you save your data in a proprietary format, the owner of the format owns your data.
<br /><A href="http://msx80.blogspot.com">http://msx80.blogspot.com</A>
You could try something like this...
http://www.hoyld.freeserve.co.uk/code/pascaldoc.html
Though I have not used it, so it would be interesting to here any reviews on it.
Umm maybe that could work.. but hasn't Delphi2005 a standard way of documenting code ?
If you save your data in a proprietary format, the owner of the format owns your data.
<br /><A href="http://msx80.blogspot.com">http://msx80.blogspot.com</A>
From my use of Delphi 2005 so far, I have not seen any 'standard' way of documenting code. But then, I have not tried all of the new features yet.
You could also try PasDoc (http://pasdoc.sourceforge.net/phpwiki/).
Thanks for the link to 'pascal doc' I think it has real potention. I see it hasn't been updated in 2 years so I made some changes for myself. (I've added menus from the explorer window to add comments intot he file).
Its nice in that it does add JavaDoc style comments intot he code for you as well as having a reporting feature to extract these comments into a document for you.
S2DL ver 1.04 will come out with some documentation now.
William Cairns
My Games: http://www.cairnsgames.co.za (Currently very inactive)
MyOnline Games: http://TheGameDeveloper.co.za (Currently very inactive)
[quote="cairnswm"]Thanks for the ]
I don't know.. but the program is 2 year old and is probably not mantined anymore..
We could ask FPK if there is an official freepascal choose among various system
If you save your data in a proprietary format, the owner of the format owns your data.
<br /><A href="http://msx80.blogspot.com">http://msx80.blogspot.com</A>
I've talked with fpk and he suggested to use PasDoc for source documentation.
So we all can now fill our code with documentation (who believe this? )
If you save your data in a proprietary format, the owner of the format owns your data.
<br /><A href="http://msx80.blogspot.com">http://msx80.blogspot.com</A>
I've tried out PasDoc and even if it's a little raw i was quite satisfacted.
I've lunched it for FunkyCars project, ad it generated the "skeleton" in a right way. (obviously there is no "documentation" in there, only the structure.. i've still to write it )
You can see the results here:
http://funkycars.sf.net/pasdoc/
What do you think about ?
If you save your data in a proprietary format, the owner of the format owns your data.
<br /><A href="http://msx80.blogspot.com">http://msx80.blogspot.com</A>
I think it's worth. Even if it's not commented, it is good to have such a nice "summary".Originally Posted by savage
here's the command i used:
Code:/home/nicola/pasdoc/PasDoc-0.8.8/source/console/PasDoc_Console --staronly -E docs/pasdoc/ src/game/*.pas src/generic/*.pas src/odeutils/*.pas
If you save your data in a proprietary format, the owner of the format owns your data.
<br /><A href="http://msx80.blogspot.com">http://msx80.blogspot.com</A>
Bookmarks