Arrays need to be documented in full. There are many areas that need to be covered. The laundry list of the areas are:
1. Quick discussion between indexed and associative arrays.
2. Quick discussion of identifying elements in an array, this can also cover data storage in an array via these different approaches at indexing. Example:
$age['Fred']=24; // Places in array $age, index 'Fred', the value 24.
3. Document the [] syntax to add an element to the end of an array.
4. Document the syntax of the following functions: range(...), count(...), sizeof(), array_pad(...), array_slice(...), array_chunk(...), array_keys(...), array_splice(...), extract(...), compact(...), array iterator functions, and a multitude of other functions used to work with arrays.
5. Document multidimensional arrays in PHP.
Documentation of Perl Regular Expressions (perl-regex) looks as if it is a task that is rather quite tedious when compared to the Posix style of regular expressions.
1. Perl-regex supports the character classes found in Posix but also define some more character classes of its own.
2. Document about: Quantifiers and Greed, Non-Capturing Groups, Backreferences, Trailing Options, Inline Options, Lookahead and Lookbehind, Cut, and Conditional Expressions.
3. Document the functions: preg_match(...), preg_replace(...), and preg_split(...)
4. At the end of chapter 4 in the O'Reilly book, there are some differences between true Perl regular expressions and PHP's style of Perl regular expressions. Documenting these minor differences may be helpful.
The quick reference has some more sample/experiment files that need to be added to the quick reference at the end of the page.
. . . . . . . . . ( end of section PHP Miscellaneous Notes & Information) <<Contents | Index>>