cvs: phpdoc / TODO

philip Thu Jul 13 02:55:38 2006 UTC Modified files: /phpdoc TODO Log: Removed some completed, and unnecessary TODO items http://cvs.php.net/viewvc.cgi/phpdoc/TODO?r1=1.56&r2=1.57&diff_format=u Index: phpdoc/TODO diff -u phpdoc/TODO:1.56 phpdoc/TODO:1.57 --- phpdoc/TODO:1.56 Thu Jul 21 17:59:33 2005 +++ phpdoc/TODO Thu Jul 13 02:55:38 2006 @@ -15,7 +15,6 @@ - usage of new docbook 4 tags for oo class documentation - language styleguide in howto (for english) and translation trees (for the other languages) - - new roles: seealso, newparameter, and changedparameter. IMPORTANT: - connection handling: what about, what got nuked? @@ -24,10 +23,6 @@ - sockets: 'available ;)' - Document all BC breaks and Deprecations, having them listed at a single location. - - add individual changelogs for each function - - consider adding beautified table for parameter definitions - and meanings. do this one extension at a time. - - see: http://marc.theaimsgroup.com/?l=phpdoc&m=103658209317795 - build PDF's - see: RFC/pdf_problems - split the developers and users manuals up. developers manual @@ -48,12 +43,7 @@ http://cvs.php.net/docweb/ BUILD SYSTEM: - - merge ZendAPI into phpdoc proper (imajes) - finish makefile cleanup (hartmut) - - support both dsssl and xsl processors with configure/make (hartmut) - problem: different processors seem to have different ideas on how - to follow relative pathes when including files using SYSTEM entities - - improve XSL stylesheet customisation - group and organize functions logically (databases, text proc, etc) (better support for that in docbook4) Needs more *discussion*: @@ -92,9 +82,6 @@ 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?) - - Update setcookie - - Document the diffs between strip[c]slashes(). Maybe just document - for both of them what they do - exactly. - Add &note.no-safemode; to the bottom of each function that is disabled in safe-mode.' - Add &note.not-threadsafe; to each extension/function @@ -107,16 +94,11 @@ - Document configure options in install.xml (mk, jan) - Acronym system: - see: http://marc.theaimsgroup.com/?l=phpdoc&m=103679111400458 - - isset, empty, "" and the like... - - see: http://marc.theaimsgroup.com/?l=phpdoc&m=103817319931363 - 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. - Add a pointers section, perhaps in types.array - (from php4/TODO): - - update curl documentation - (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