vBdoc - Source code documentation in the admincp [no longer supported]
 

[high]This modification is no longer supported![/high] -

Jelsoft has released their own source code documentation, thus I will no longer be working on this project or making new html files from the source code.

See this thread to get the link to the offical API documentation.

Nice one Brad ;)

Satan

sorry kinda confused, is this a phpdoc compilation of beta 4? are you going to update it in each new version

alright brad, maybe im dumb but..I would love something like that for 3.0.X..does it list the source php files in your admin cp? Is that what it does.

No. phpDoc is a comment syntax for giving documentation on functions and classes inside the files themselves.

It is not available in 3.0.x (because the devs didnt use it).

Brad: Did you manage to reduce the number of errors by changing configurations or is it the syntax that Jelsoft are using that is causing most of the errors?

Yes this is beta 4 as noted in the zip file :). With each version I will generate new files.

I do plan on going back and cleaning up the .html files, right now they are what phpdoc generated with no modification.

You can see the error log at /docs/vbsource/errors.html, while there are a lot listed there note that many of them are because of two things. Illegal use of 'var' and redeclared defines.

One thing for others that want to make their own phpdoc files, you need to tell phpdoc to pick up on a custom tag vB uses. Make sure you tell it to look for 'date' so it will extract @date.

Keep in mind that we are dealing with beta code, and I'm no phpdoc expert :). Even with the errors phpdoc still pulls a ton of useful information ;)

So why is the navigation link pointing to /forums/docs/ instead of /forums/admincp/docs/ ?:p

Remove the [high]/[/high] before the docs in the link in the .xml file :p

Satan

Brad, in the xml you should replace:
<link>/docs/vbsource/index.html</link>

with:
<link>./docs/vbsource/index.html</link>

doh! I got ya now, I guess I was thinking about somthing else/dreaming :-D

Hmmm strange it was right on localhost but wrong in the zip file, updating zip now (the joy of uploading 1.29MB on a 16.8k connection :rolleyes:)