Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:103553
To: =?UTF-8?Q?C=c3=b4me_Chilliet?= <come@opensides.be>,
 internals@lists.php.net
References: <CAEKnhAEOZ4pHToNtHr+fX617MZSyH1hHvK5eyahspoLJBrFEbQ@mail.gmail.com>
 <2392014.XkQXtmkjIS@mcmic-probook>
 <c0df78c0-6f9d-08f5-6fbd-51699ee6e264@gmx.de>
 <1784734.hqeSHGFPS1@mcmic-probook>
Message-ID: <8429dfe1-3b47-246e-dc93-f3ddc1220c33@gmx.de>
Date: Tue, 4 Dec 2018 16:35:14 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101
 Thunderbird/60.3.2
MIME-Version: 1.0
In-Reply-To: <1784734.hqeSHGFPS1@mcmic-probook>
Content-Type: text/plain; charset=utf-8
Content-Language: de-DE
Content-Transfer-Encoding: 8bit
Subject: Re: [PHP-DEV] Re: 7.3 features in announcement
From: cmbecker69@gmx.de ("Christoph M. Becker")

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