Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969384440 php.internals:67757
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain adamharvey.name designates 209.85.223.172 as permitted sender)
MIME-Version: 1.0
Sender: adam@adamharvey.name
In-Reply-To: <CAMUwpuTVZzLLvqS4aydGY7tUm4f8bJwOfc49HW-h-9dHFKOKow@mail.gmail.com>
References: <CAMUwpuStek+AzAouybK3-gYvK47xWh2dFdjVKLKtaR5iJ1zfhQ@mail.gmail.com>
 <CAMUwpuTVZzLLvqS4aydGY7tUm4f8bJwOfc49HW-h-9dHFKOKow@mail.gmail.com>
Date: Thu, 20 Jun 2013 14:51:47 -0700
Message-ID: <CADajX4DM05ah+0pKa7YOCESH24jmQWWrZfuFE5J1=96rxLpOQQ@mail.gmail.com>
To: Julien Pauli <jpauli@php.net>
Cc: PHP Internals <internals@lists.php.net>, PHP Documentation ML <phpdoc@lists.php.net>, 
	Dmitry Stogov <dmitry@php.net>, Laruence <laruence@php.net>, 
	Hannes Magnusson <hannes.magnusson@gmail.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Subject: Re: [PHP-DOC] Re: OPCache documentation
From: aharvey@php.net (Adam Harvey)

On 20 June 2013 14:36, Julien Pauli <jpauli@php.net> wrote:
> On Wed, May 15, 2013 at 3:54 PM, Julien Pauli <jpauli@php.net> wrote:
>>
>> Hi all,
>>
>> As you know, 5.5 final is coming soon.
>> We are in RC, so mainly stabilizing stuff and preparing the final releas=
e
>> for anyone to setup 5.5 on their servers.
>>
>> I see the documentation migration guide has already been commited, that'=
s
>> a good new.
>> I also see that new features we ship in 5.5 are online in the
>> documentation, great !
>>
>> But a crucial feature is missing doc : OPCache.
>>
>> As this feature is a very big step in PHP's life (we finally have a
>> recommanded, bundled opcode cache system, and I'm very proud of this
>> personnaly), I think it is crucial to have a good documentation about it=
.
>>
>> Has anyone started to write some doc about OPCache ?
>>
>> Another subject is APC. We have its doc on php.net, all right.
>> What I would like is we patch APC doc when 5.5 final gets released, to
>> clearly show our mind about it.
>> That way, any people using 5.5 should be able to read in the doc that AP=
C
>> has support has been interrupted, that APC should never be used together
>> with OPCache, and that OPCache is now the standard recommanded OPCode
>> caching solution for 5.5, 5.4 and 5.3.
>>
>> It is crucial to communicate one this point for our users.
>>
>> Then will come the "User cache" debate
>>
>> Thank you.
>
>
>
> Up. Could we at least plan such a project ?
> 5.5 is released now. I know we are still having trouble about OpCache
> particulary under Windows. I dont shadow that.
> I would just like we start thinking about writing documentation for OPCac=
he
> features and merge them to our official documentation. If it's already
> planned by someone, just let me know ;-)

I'm working on some basic opcache documentation as we speak, since it
was pointed out on #php.doc. That said, mostly what I'm doing for now
is adapting the README in ext/opcache and documenting opcache_reset()
and opcache_invalidate() =E2=80=94 some additional theory of operating and
setup documentation would be very welcome.

There should be something to look at in SVN in the next hour or so.

My apologies =E2=80=94 I wrote the first draft of the migration guide in th=
e
mid alpha stage (ie before opcache was merged) of 5.5 with the
intention of going back to flesh it out before the final release, but
time has been a bit of an issue. Turns out moving halfway across the
world is a real time sink.

Adam