cvs: phpdoc / TODO

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 &note.no-safemode; to the bottom of each function that is - disabled in safe-mode.' - Add &note.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