Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:43014 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 52495 invoked from network); 11 Feb 2009 22:40:17 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 11 Feb 2009 22:40:17 -0000 Authentication-Results: pb1.pair.com header.from=mls@pooteeweet.org; sender-id=unknown Authentication-Results: pb1.pair.com smtp.mail=mls@pooteeweet.org; spf=permerror; sender-id=unknown Received-SPF: error (pb1.pair.com: domain pooteeweet.org from 88.198.8.16 cause and error) X-PHP-List-Original-Sender: mls@pooteeweet.org X-Host-Fingerprint: 88.198.8.16 bigtime.backendmedia.com Linux 2.6 Received: from [88.198.8.16] ([88.198.8.16:46115] helo=bigtime.backendmedia.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id E6/B9-12172-0D353994 for ; Wed, 11 Feb 2009 17:40:17 -0500 Received: from localhost (unknown [127.0.0.1]) by bigtime.backendmedia.com (Postfix) with ESMTP id 47E484144057; Wed, 11 Feb 2009 22:40:54 +0000 (UTC) X-Virus-Scanned: amavisd-new at backendmedia.com Received: from bigtime.backendmedia.com ([127.0.0.1]) by localhost (bigtime.backendmedia.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id TR1pOhvO1e5V; Wed, 11 Feb 2009 23:40:53 +0100 (CET) Received: from [192.168.0.151] (77-58-151-147.dclient.hispeed.ch [77.58.151.147]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) (Authenticated sender: mls@pooteeweet.org) by bigtime.backendmedia.com (Postfix) with ESMTP id DB27D4144009; Wed, 11 Feb 2009 23:40:52 +0100 (CET) Cc: Steph Fox , Pierre Joye , Vesselin Kenashkov , PHP Internals List Message-ID: <6836D93C-CB43-4E15-9ABA-C479FBCCA035@pooteeweet.org> To: Hannes Magnusson In-Reply-To: <7f3ed2c30902111420n56ecd4cbl5f95b2e2e511de6@mail.gmail.com> Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Mime-Version: 1.0 (Apple Message framework v930.3) Date: Wed, 11 Feb 2009 23:40:11 +0100 References: <53C9D049-8C10-48F2-8312-C8A81D2B5990@pooteeweet.org> <00a601c98c7b$4ed5a4a0$919f644d@foxbox> <7f3ed2c30902111113q364b4094q22c71c1046a984a6@mail.gmail.com> <00c301c98c7d$da9cce80$919f644d@foxbox> <00d401c98c7e$a92bfcd0$919f644d@foxbox> <261daaa10902111131u61ad7ec9s9257a45e1e11f086@mail.gmail.com> <00ec01c98c81$2696b2d0$919f644d@foxbox> <00f501c98c82$b8c560b0$919f644d@foxbox> <7f3ed2c30902111420n56ecd4cbl5f95b2e2e511de6@mail.gmail.com> X-Mailer: Apple Mail (2.930.3) Subject: Re: [PHP-DEV] 5.3 todos From: mls@pooteeweet.org (Lukas Kahwe Smith) Hey Steph, Personally I think we should list all changes. For certain changes we should devote some explanations (like E_DEPRECATED). For the most part I see this document as a place where we provide an overview of things which then gives them the right key word to look in the documentation. Also like in the case of E_DEPRECATED we should briefly explain the reasoning and how people should adapt their php.ini files .. so in that sense all longer text should be about migration issues, where are documentation is more about documenting the behavior in each version. I expect some people to skim this document, others to read it to the letter, others will just grep it if they run into issues. Thinking about it, we should somehow try and make sure that any likely error message that people will see in their error logs after upgrading will get them a hit when they search for it in this document. So in summary, I feel the key point for this document is: - a single document that lists all changes - contains pointers that enables someone to look up more details in the documentation - enables people who get new "strange" error messages to find pointers towards the documentation - some lengthier migration related explanations that go beyond what we want to provide in the documentation regards, Lukas