Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:60220 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 72162 invoked from network); 19 Apr 2012 18:16:03 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 19 Apr 2012 18:16:03 -0000 Authentication-Results: pb1.pair.com header.from=christopher.jones@oracle.com; sender-id=pass Authentication-Results: pb1.pair.com smtp.mail=christopher.jones@oracle.com; spf=pass; sender-id=pass Received-SPF: pass (pb1.pair.com: domain oracle.com designates 148.87.113.117 as permitted sender) X-PHP-List-Original-Sender: christopher.jones@oracle.com X-Host-Fingerprint: 148.87.113.117 rcsinet15.oracle.com Received: from [148.87.113.117] ([148.87.113.117:21049] helo=rcsinet15.oracle.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 88/99-18164-166509F4 for ; Thu, 19 Apr 2012 14:16:02 -0400 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q3JIFubQ027869 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 19 Apr 2012 18:15:57 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q3JIFtC7021680 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 19 Apr 2012 18:15:56 GMT Received: from abhmt107.oracle.com (abhmt107.oracle.com [141.146.116.59]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q3JIFtLF018362; Thu, 19 Apr 2012 13:15:55 -0500 Received: from [130.35.70.154] (/130.35.70.154) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 19 Apr 2012 11:15:54 -0700 Message-ID: <4F90565A.50405@oracle.com> Date: Thu, 19 Apr 2012 11:15:54 -0700 User-Agent: Mozilla/5.0 (X11; Linux i686; rv:11.0) Gecko/20120327 Thunderbird/11.0.1 MIME-Version: 1.0 To: Gustavo Lopes CC: Stas Malyshev , "internals@lists.php.net" References: <4F80DE16.1020407@sugarcrm.com> <4F8F37F8.8020308@sugarcrm.com> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-CT-RefId: str=0001.0A090202.4F90565E.0048,ss=1,re=0.000,fgs=0 Subject: Re: [PHP-DEV] Re: Addition of calendar to intl From: christopher.jones@oracle.com (Christopher Jones) On 04/19/2012 12:53 AM, Gustavo Lopes wrote: > On Wed, 18 Apr 2012 23:54:00 +0200, Stas Malyshev wrote: > >>> I think the documentation part in this case is not as problematic, >>> because the interface has been thoroughly documented in the ICU >>> project. Most of your next questions can be answered by reading >>> >>> http://userguide.icu-project.org/datetime/calendar >> >> This is ICU docs, not PHP docs. Most PHP users wouldn't even know where >> to find it, let alone how to use it applied to PHP. We need something to >> list the functions and what they do. > > It's ICU docs, but they're applicable here after doing the obvious substitutions (replace all integer types with PHP's integer, etc.). > You can list the functions with php --rc IntlCalendar or similar and then refer to that document for the functions' behavior. Of course, this doesn't replace PHP documentation, but it's not urgent at this stage given PHP 5.5 being one year away and the ICU > docs giving almost all information to those who want to play with it. Hi Gustavo, Can you add at least placeholder stub pages to the PHP docs sooner rather than later? Or even just one page listing the changes? Thanks, Chris -- christopher.jones@oracle.com http://twitter.com/#!/ghrd