philip Thu May 24 23:07:03 2007 UTC
Modified files:
/phpdoc TODO
Log:
Removed old TODO's - some were completed while others are irrelevant today
http://cvs.php.net/viewvc.cgi/phpdoc/TODO?r1=1.62&r2=1.63&diff_format=u
Index: phpdoc/TODO
diff -u phpdoc/TODO:1.62 phpdoc/TODO:1.63
--- phpdoc/TODO:1.62 Wed May 23 21:26:13 2007
+++ phpdoc/TODO Thu May 24 23:07:03 2007
@@ -16,11 +16,7 @@
- language styleguide in howto (for english) and translation
trees (for the other languages)
-IMPORTANT:
- - connection handling: what about, what got nuked?
-
BIG JOBS:
- - sockets: 'available ;)'
- Document all BC breaks and Deprecations, having them listed
at a single location.
- build PDF's
@@ -31,8 +27,7 @@
- see: RFC/protocol_20020310
see: http://www.php-ev.de/documents/phpdoc/protocol.html
- document every undocumented function.
- - see: http://www.zend.com/phpfunc/nodoku.php
- http://www.phpdoc.info/meta/phpsrc-vs-phpdoc.php
+ see: http://www.phpdoc.info/meta/phpsrc-vs-phpdoc.php
http://doc.php.net/php/undoc_functions.php
- add an example to most every function
- see: http://doc.php.net/php/missing_examples.php
@@ -76,22 +71,10 @@
GENERAL:
- Merge php-src/CODING_STANDARDS with Zend API documentation
- - Review PECL resources available at
http://pecl.php.net/support.php#tutorials
- and merge them into Zend API where appropriate
- Document php://stdout etc feature for file functions.
(superseded by need of general description of the new streams features?)
- - Add ¬e.no-safemode; to the bottom of each function that is
- disabled in safe-mode.'
- Add ¬e.not-threadsafe; to each extension/function
that is not thread safe
- - add platform availability
- - Mark binary (un)safe functions
- - Add link to an example in the &tip.ob-capture; Put this example
- and further explanation in a faq entry)
- - Bug the dev's to rename functions like hw_getobjectbyquerycollobj
- - Document configure options in install.xml (mk, jan)
- - Acronym system:
- - see: http://marc.theaimsgroup.com/?l=phpdoc&m=103679111400458
- go through and make sure every function that takes on a parameter
by reference has an example that clearly demonstrates that it's
not a reference passed at call time.
@@ -99,7 +82,5 @@
- Tool: check all 'see also' links and ensure they are valid. For
example, make sure a function exists.
- (from bugs):
- - see
http://bugs.php.net/search.php?search_for=&boolean=0&limit=All&order_by=status&direction=ASC&cmd=display&status=Open&bug_type%5B%5D=Documentation+problem&php_os=&phpver=&assign=&author_email=&bug_age=0
-
-
+BUGS
+ - Open: http://tinyurl.com/4vufw