Tycoon Talk
Become a Big fish!
The number 1 forum for online business!
Post topics, ask questions, share your knowledge.
Tycoon Talk is part of Freelancer.com - find skilled workers online at a fraction of the cost.

PHP Forum


You are currently viewing our PHP Forum as a guest. Please register to participate.
Login



Freelance Jobs

View Poll Results: Do you use phpDoc?
Yes, I use it 2 28.57%
No, I don't use it 2 28.57%
I didn't know about it before, but it looks interesting 1 14.29%
I didn't know about it before, but I don't think I'll be using it 0 0%
I don't have any idea what it is or what it's used for! 2 28.57%
Voters: 7. You may not vote on this poll

Reply
Old 05-24-2005, 07:47 PM Who Uses phpDoc?
Christopher's Avatar
Iced Cap

Latest Blog Post:
Cross-domain AJAX with JSONP
Posts: 3,110
Location: Toronto, Ontario
Trades: 0
Just wanted to take a quick poll and see who uses phpDoc.

I used to look at code documented with phpDoc and think it was ugly (I'm a freak about neat code ). But I started to use it about a week ago and I'm really starting to like it.

Other than making it extremely easy to generate documentation, it helps me remember my own functions If you've ever had the pleasure of coding large projects with lots of separate files, modules and functions -- you know you can easily get lost once you move from one major part to another.

Note: This is a public poll
__________________

Please login or register to view this content. Registration is FREE
- Latest Articles:
Please login or register to view this content. Registration is FREE
,
Please login or register to view this content. Registration is FREE

--
Please login or register to view this content. Registration is FREE

Christopher is offline
Reply With Quote
View Public Profile
 
 
Register now for full access!
Old 05-24-2005, 07:56 PM
0beron's Avatar
Defies a Status

Posts: 1,832
Location: Somewhere else entirely
Trades: 0
I've not used it, although I don't think I've worked on anything big enough to merit it so far. I fit in the 'I've not used used it, have a rough idea what it does, but haven't bothered to investigate further' category. Used javadoc on a collaborative project last year for Uni, but never phpDoc. I remember my functions by adding small comments here and there.
__________________
UPDATE 0beron SET talkupation = talkupation + lots WHERE post = 'helpful';

Please login or register to view this content. Registration is FREE
(aka MSN handwriting for forums)
0beron is offline
Reply With Quote
View Public Profile Visit 0beron's homepage!
 
Old 05-24-2005, 08:02 PM
Gaffer Sports's Avatar
Ultra Talker

Posts: 397
Name: Steve
Location: Scotland
Trades: 1
The Lazy Mans Tool.

Not for me!!! As you mentioned, I also like clean code and I detest anything that manipulates my way of thinking.
__________________

Please login or register to view this content. Registration is FREE
-
Please login or register to view this content. Registration is FREE
Gaffer Sports is offline
Reply With Quote
View Public Profile Visit Gaffer Sports's homepage!
 
Old 05-24-2005, 08:23 PM
Christopher's Avatar
Iced Cap

Latest Blog Post:
Cross-domain AJAX with JSONP
Posts: 3,110
Location: Toronto, Ontario
Trades: 0
I don't think it's ugly anymore. The only thing that I find a bit ugly is when there are 4 lines of phpDoc blocks for one variable. For example:
PHP Code:
    /**
     * @access private
     * @var object Configuration settings
     */
    
var $CFG;


    
/**
     * @access private
     * @var object Common functions
     */
    
var $FUNC;


    
/**
     * @access private
     * @var object Event handler
     */
    
var $Events;


    
/**
     * @access private
     * @var object Database driver
     */
    
var $DB;


    
/**
     * @access private
     * @var object Query builder
     */
    
var $Query;


    
/**
     * @access private
     * @var array System options and settings
     */
    
var $options;


    
/**
     * @access private
     * @var object User session handler
     */
    
var $User;


    
/**
     * @access private
     * @var object Template handler
     */
    
var $TPL
Those 40 or so lines (excluding the whitespace) would normally be 8.

But I've gotten used to it. I usually use jEdit to collapse most of the phpDoc comment blocks anyway.
__________________

Please login or register to view this content. Registration is FREE
- Latest Articles:
Please login or register to view this content. Registration is FREE
,
Please login or register to view this content. Registration is FREE

--
Please login or register to view this content. Registration is FREE

Christopher is offline
Reply With Quote
View Public Profile
 
Old 05-24-2005, 08:30 PM
Gaffer Sports's Avatar
Ultra Talker

Posts: 397
Name: Steve
Location: Scotland
Trades: 1
and what was wrong with good old fashioned manual entry?
__________________

Please login or register to view this content. Registration is FREE
-
Please login or register to view this content. Registration is FREE
Gaffer Sports is offline
Reply With Quote
View Public Profile Visit Gaffer Sports's homepage!
 
Old 05-24-2005, 08:38 PM
Christopher's Avatar
Iced Cap

Latest Blog Post:
Cross-domain AJAX with JSONP
Posts: 3,110
Location: Toronto, Ontario
Trades: 0
It takes more effort The manual way, you'd have two things to update every time you wanted to make a change. Not to mention the overhead of taking care of the actual packaging of your documentation. And you're more likely to update your documentation while you're down and dirty with the code, instead of having to dig into some obscene HTML.

Then to anyone else just browsing code, all the information is right there -- they don't even need to open up the docs and browse to any particular page to get the information they need.
__________________

Please login or register to view this content. Registration is FREE
- Latest Articles:
Please login or register to view this content. Registration is FREE
,
Please login or register to view this content. Registration is FREE

--
Please login or register to view this content. Registration is FREE

Christopher is offline
Reply With Quote
View Public Profile
 
Old 05-25-2005, 08:19 AM
ibbo's Avatar
Super Spam Talker

Posts: 880
Location: Leeds UK
Trades: 0
I have been using it for the past 18 month or so.

The good points of it are easy to see.

I am new at your place and have to work out what you have been doing. Since you commented all your methods I can instantly get the jist for what your doing and how its been done.

Without this my hack time has just increased ten fold.

So sure if your not putting hundreds of lines of code in your scripts then you may find it a little overkill.
But every good programmer should also be aware that it is good practice to comment your code.

If you dont comment your work then just remember you have only done half your job.

I dont suppose you UML your stuff aswell do you Chroder? if so what patterns if any do you find you use over and over again.

Ibbo
__________________

Please login or register to view this content. Registration is FREE

Please login or register to view this content. Registration is FREE

Please login or register to view this content. Registration is FREE

Please login or register to view this content. Registration is FREE

Linux user #349545 :
(GNU/Linux)iD8DBQBAzWjX+MZAIjBWXGURAmflAKCntuBbuKCWenpm XoA7LNydllVQOwCf
ibbo is offline
Reply With Quote
View Public Profile Visit ibbo's homepage!
 
Old 05-25-2005, 01:20 PM
Christopher's Avatar
Iced Cap

Latest Blog Post:
Cross-domain AJAX with JSONP
Posts: 3,110
Location: Toronto, Ontario
Trades: 0
Quote:
I dont suppose you UML your stuff aswell do you Chroder?
Not at the moment. I've looked into it somewhat, but I prefer to jot down my ideas differently (I've got a whiteboard by my desk with a bunch of scribblings on it). I really should give it a try from the get-go.

If not for planning, I probably would take the time to make the models afterwards so others could visually see the application 'frame'.
__________________

Please login or register to view this content. Registration is FREE
- Latest Articles:
Please login or register to view this content. Registration is FREE
,
Please login or register to view this content. Registration is FREE

--
Please login or register to view this content. Registration is FREE

Christopher is offline
Reply With Quote
View Public Profile
 
Reply     « Reply to Who Uses phpDoc?
 

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are Off
Pingbacks are Off
Refbacks are Off





   
RSS Feed  Feeds: RSS   JS   XML
RSS Feed  Feeds for this forum: RSS   JS   XML



Page generated in 1.21181 seconds with 13 queries