-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathTODO
42 lines (36 loc) · 1.59 KB
/
TODO
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
TODO for the PHP documentation project.
Last update date: $LastChangedDate$
Add things that should be updated/added in the documentation here. For
big (i.e. time-consuming) items, add your name to it when you start
working on it, to prevent double-work.
BIG JOBS:
- build PDF's
- see: RFC/pdf_problems
- Move the "developers manual" (internals) to http://dev.php.net
- see: RFC/manual_splitting
- integrate the meeting findings from the protocol
- see: RFC/protocol_20020310
- document every undocumented function.
- add an example to most every function
BUILD SYSTEM:
- get back lost indexes, but add them as appendices
(index of tables, index of examples, index of config options)
- add legacy.ent
- see: http://marc.theaimsgroup.com/?l=phpdoc&m=103893809326045
- generate a list of all php.ini configure options
- generate a list of all install configure options
- generate a list of all requirements from all resources.xml
GENERAL:
- Go through the FIXMEs comments
- Document php://stdout etc feature for file functions.
(superseded by need of general description of the new streams features?)
- Add ¬e.not-threadsafe; to each extension/function
that is not thread safe
- 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
- Tool: check all 'see also' links and ensure they are valid. For
example, make sure a function exists.
BUGS
- Open: http://bit.ly/phpdocbugs