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