On 04.12.2018 at 16:09, Côme Chilliet wrote: > Le lundi 3 décembre 2018, 12:37:45 CET Christoph M. Becker a écrit : >> Thanks! Indeed, PR #2640 looks like a considerable improvement. Please >> add a respective entry in UPGRADING (either self-explaining, or linking >> to another document). > > I started https://secure.php.net/manual/en/ldap.controls.php and adding > documentation for the new functions as well
Thanks on behalf of the doc team! > (The online version is outdated last version is in the svn). Yeah, the PHP manual is rolled out only once a day to the mirrors. docs.php.net is supposed to be updated every 4 or 6 hours. > It’s not clear for me in which branch I should edit UPGRADING, it seems > master is now 7.4, should I edit in PHP-7.3 or PHP-7.3.0? What’s the > difference? PHP-7.3 is the main branch for 7.3; please commit relevant changes to UPGRADING there (and merge up to master). PHP-7.3.0 is the release branch, which usually is maintained by the RMs only, who cherry-pick important commits from PHP-7.3 into it. > Also what is the difference between UPGRADING and NEWS? NEWS is for all news (including bug fixes), and usually has only very brief notes. Also it has sections for every PHP *revision*, and is made available as change log[1]. UPGRADING has often more verbose information which serves as upgrading information for a *minor* PHP version. UPGRADING also serves as base for the migration guide[2] in the PHP manual. > Regarding the online documentation, it seems http://doc.php.net/tutorial/ is > down as well as http://docs.php.net/ Indeed! Guess we should wait a while, and if it's still not up again then, someone should file a bug report. [1] e.g. <http://php.net/ChangeLog-7.php#7.2.12> [2] e.g. <http://php.net/manual/en/migration72.php> -- Christoph M. Becker -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
