Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:95443 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 44128 invoked from network); 25 Aug 2016 11:30:10 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 25 Aug 2016 11:30:10 -0000 Authentication-Results: pb1.pair.com header.from=rowan.collins@gmail.com; sender-id=pass Authentication-Results: pb1.pair.com smtp.mail=rowan.collins@gmail.com; spf=pass; sender-id=pass Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.192.174 as permitted sender) X-PHP-List-Original-Sender: rowan.collins@gmail.com X-Host-Fingerprint: 209.85.192.174 mail-pf0-f174.google.com Received: from [209.85.192.174] ([209.85.192.174:35274] helo=mail-pf0-f174.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id E2/41-34481-FB6DEB75 for ; Thu, 25 Aug 2016 07:30:08 -0400 Received: by mail-pf0-f174.google.com with SMTP id x72so17154217pfd.2 for ; Thu, 25 Aug 2016 04:30:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-transfer-encoding; bh=vtSU1IqLbRsx7ymt0Nk6VfkI87PvdEvSsGkxESsA/kw=; b=v2GLGYG1vU9ohKJWkJFXFPC18rdphe8qvASl85bcbGbw6MLE304hYl0kmlohuZbm+K BmpfljI+pH6yVJT24u7cDbVn0Z7CqJ428OfceRKjd+fTrm2NQFWDQUjN89PUINbV6oR3 aIolUrwo4EWHVpDf7I9kfLzckNzO21SRNxrhK6cELZKFaAkVVQM4y900DvytZMZsHM10 BgeboAmttf2C+RujT5dAOyqO23w79v6l5ZrPglRLe5SkdFQumCa80WDSl3UxvELQMlTt d8Z1I/pUMKzKf5YKQSwUUHOHpQLFCg+b7Ec9o+2xgnIpd4HOMLOBLDhXfFNfwqGP5dt9 2C2w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding; bh=vtSU1IqLbRsx7ymt0Nk6VfkI87PvdEvSsGkxESsA/kw=; b=fJY7LwYJTwTWUuql8visAcrkc61dYMSSjZHMfFoAhY1uqkEh88WBfQ8A/K5vtzl/jL D2TgZ5TMlBjZ+GXLKksRH9K9Pr5p8WKraRfI9RFIrOZ1Jj732W9LjBCkLIhRZ/uGyq6H MFLdtejy6fIQ68yCs/CpLDMyYHlKzV/d5ntL4ohXTEFD2HmL1qpxbYq70/goB3gDbU6c oIZp0jBJx7I+Q4QwBUZ+9qMx23quOcEwiZAijhUfi1kPQOr4LiMW5O4Hvhixj09NI4UK KFHyem6rZ5K2tSPTKr67sJUuNKvJBGsqqXoY6CPxfFJ7mREQGqqmiBoxWORpQG27B77x eUrw== X-Gm-Message-State: AE9vXwNa09ZTqTPD7Rdf/dNcSLEkVCGmm78r0QOKVUfptslj0oxQX5HjxneQY5EGvVdF0A== X-Received: by 10.98.62.65 with SMTP id l62mr15319095pfa.2.1472124604376; Thu, 25 Aug 2016 04:30:04 -0700 (PDT) Received: from [192.168.0.98] ([93.188.182.58]) by smtp.gmail.com with ESMTPSA id ah5sm20303583pad.30.2016.08.25.04.30.02 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 25 Aug 2016 04:30:03 -0700 (PDT) To: internals@lists.php.net References: <3938d503-e622-b6ae-2f9e-b0efa16074be@lsces.co.uk> Message-ID: Date: Thu, 25 Aug 2016 12:28:20 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0 MIME-Version: 1.0 In-Reply-To: <3938d503-e622-b6ae-2f9e-b0efa16074be@lsces.co.uk> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [PHP-DEV] Write down a deprecation policy From: rowan.collins@gmail.com (Rowan Collins) On 25/08/2016 12:10, Lester Caine wrote: > Is there any well documented alternative way of achieving the same > results as provided by these functions? Much of the time there is > on-list debates on how something should be done, but it gets somewhat > watered down in a migration guide ... if it makes it there at all. In this specific case, look at http://php.net/manual/en/function.iconv.php or http://php.net/manual/en/function.mb-convert-encoding.php But in general, yes, as Dave Walker mentioned, documenting proper migration steps should be a standard part of any deprecation. Much as I appreciate the Meaningless Internet Points it's earning me, this Stack Overflow post explaining preg_replace_callback should really have been a prominently-linked page in the official manual: http://stackoverflow.com/a/15454454/157957 Regards, -- Rowan Collins [IMSoP]