Doc #62486 [NEW]: Missing documentation for DatePeriod

From: logos-php at kith dot org Operating system: Linux PHP version: Irrelevant Package: Date/time related Bug Type: Documentation Problem Bug description:Missing documentation for DatePeriod Description: ------------ --- From manual page: http://www.php.net/class.dateperiod --- The DatePeriod page doesn't give any information that I can find about the class of the objects that result from iterating over it. In particular, as far as I can tell, if you do a foreach on a DatePeriod, the instances of the iterator are DateTime objects. Which is great--it's exactly what I wanted--but it doesn't appear to be documented. Perhaps it's obvious to people who know more about iterators. But for me, I had to figure it out by reading people's posts, and confirm it by reading this Stack Overflow answer: (http://stackoverflow.com/questions/3416288/parameterizing-php- code-with-dateperiod-dateinterval-classes) More generally, the DatePeriod page doesn't really explain at all what a DatePeriod is or how to use it. Fortunately, the user-supplied examples help a lot with that. -- Edit bug report at https://bugs.php.net/bug.php?id=62486&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=62486&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=62486&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=62486&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=62486&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=62486&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=62486&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=62486&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=62486&r=needscript Try newer version: https://bugs.php.net/fix.php?id=62486&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=62486&r=support Expected behavior: https://bugs.php.net/fix.php?id=62486&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=62486&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=62486&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=62486&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=62486&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=62486&r=dst IIS Stability: https://bugs.php.net/fix.php?id=62486&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=62486&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=62486&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=62486&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=62486&r=mysqlcfg