This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 133837 - The PHP Doc is often incomplete
Summary: The PHP Doc is often incomplete
Status: RESOLVED FIXED
Alias: None
Product: php
Classification: Unclassified
Component: Project (show other bugs)
Version: 6.x
Hardware: All All
: P3 blocker (vote)
Assignee: Petr Pisl
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-04-24 13:48 UTC by Petr Pisl
Modified: 2008-07-30 10:41 UTC (History)
4 users (show)

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
screenshot (9.14 KB, text/plain)
2008-07-30 08:46 UTC, Michael Nazarov
Details
screenshot (9.14 KB, image/png)
2008-07-30 08:46 UTC, Michael Nazarov
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Petr Pisl 2008-04-24 13:48:19 UTC
Invoce cc mysql_fetch_object and look at the dynamic window. The last line of the php doc is  "RETURN object an object
with string properties that correspond to the"

There is many cases of such unfinished php doc.
Comment 1 Petr Pisl 2008-05-22 16:24:25 UTC
Other suspicious documentation you can see for mysql_db_name and mysql_db_query
Comment 2 Tomasz Slota 2008-05-30 13:41:06 UTC
This is because the stub file we took from PDT has broken PHPDoc. We need to generate our own stub files. I think this actually belongs to 'project', 
reassigning to tmysik.
Comment 3 Tomas Mysik 2008-05-30 13:54:05 UTC
Petre, do you know who is going to generate our own signature files? And when? Thanks.
Comment 4 Petr Pisl 2008-05-30 16:47:08 UTC
I take this issue. I will generate the files. 
Comment 5 Petr Pisl 2008-07-17 17:12:12 UTC
Now in main there new files, with better documentation. Marking as fixed. 
Comment 6 Michael Nazarov 2008-07-30 08:45:41 UTC
Product Version: NetBeans IDE Dev (Build 200807300201)
Java: 1.6.0_10-beta; Java HotSpot(TM) Client VM 11.0-b12
System: Windows XP version 5.1 running on x86; Cp1251; ru_RU (nb)

Checked with some functions and did not found cuttet documentation, so it
looks good. But I found some strange functions without any documentation.
For example there is mysql_num_rows() with correct doc and in same time
mysql_numrows() without any docs. First one is real php function and what
is second one? Possibly this is not docs issue but issue with runtime
files. Some kind of artifacts?
See screenshot also.
Comment 7 Michael Nazarov 2008-07-30 08:46:22 UTC
Created attachment 66030 [details]
screenshot
Comment 8 Michael Nazarov 2008-07-30 08:46:27 UTC
Created attachment 66031 [details]
screenshot
Comment 9 Michael Nazarov 2008-07-30 08:47:33 UTC
Sorry for first attachment with text MIME...
Comment 10 Petr Pisl 2008-07-30 10:39:20 UTC
You are right, there are some functions without a documentation. Unfortunately there is not documentation for them at
php.net. There is not fast solution for this. We can manually write it, but it's not the right solution.
Comment 11 Michael Nazarov 2008-07-30 10:41:35 UTC
Well, as I can see there is no any kind of documentation about mysql_numrows()
function even on http://php.net/ so my question is why is this function here?