Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:106706
Return-Path: <george.banyard@gmail.com>
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 76712 invoked from network); 26 Aug 2019 18:36:00 -0000
Received: from unknown (HELO mail-vs1-f49.google.com) (209.85.217.49)
  by pb1.pair.com with SMTP; 26 Aug 2019 18:36:00 -0000
Received: by mail-vs1-f49.google.com with SMTP id j25so11291265vsq.12
        for <internals@lists.php.net>; Mon, 26 Aug 2019 09:07:41 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20161025;
        h=mime-version:references:in-reply-to:from:date:message-id:subject:to
         :cc;
        bh=3+g+g31i6dCg6ZBbI4I18MvAHamZ/T85H0C/BebDG5U=;
        b=GcmlM+7seY5DpeN23GFuNcpCkEOMTehbHq3jw5+dE5KMRtiFRdXJ43jn41A0AQCdmm
         pk0g6+ooIRPgcgKidRPavlYlFlq381tj8T4ao1w79jg7RZ6qpzASVF4spA+BtXeMZFE0
         57S+j1Vb4sDbAw7PZjVcCHXi3qyy6F1Xmj5yyedg5E0x85zld8xGR8sD09+sGMGHkiSs
         7rmraW5CeUYaWKkvaiCojBrGXYbBpB1j+RdVvLiDf6uY5QxoDEyNxqtsZaBJ+bLAF5E6
         KYlm4JG/6uH4+Cx/a3kfLtZOsag7q2d12NqWPuSOXz8Af20Lt4qwDvdnB8NpQqxg7Fsl
         cHig==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20161025;
        h=x-gm-message-state:mime-version:references:in-reply-to:from:date
         :message-id:subject:to:cc;
        bh=3+g+g31i6dCg6ZBbI4I18MvAHamZ/T85H0C/BebDG5U=;
        b=GzB5fCxrvDLbOXrv1zyNBIO8+IR+7Na1vDggMFre8/oJd5KmhhSuOJdmhffCPsX3HC
         XHQ0BXSJ8DwvXMopfgp1rK5sBOBdfW7cZe03jBPrSgLib5BPqiuKB4/amF7g6RsQyi19
         6C0ZQEn7tE9ozRWjPkV9VyEotMzjM7943xznxTY74qi2r/UjO+08mR22UekMCgwAXlyO
         jU3gQNBpLKOtZOCANiSh8/nOMACUEBFC8YHdMjP6fmFVyFbQ6+R4s9EZhPcdZEcij5PX
         Lc1QDfQRyOruVCucJ4kLs3P1E0P/YWzf07j4Kx7OBw9rqzHmaqrcLmO+a3awr/YEQMXw
         5JLw==
X-Gm-Message-State: APjAAAWbdKq4sqK43IEDN2XXXv2BpfJNEzhn2luzYAC/g9hMoGsOtkmy
	F5NtiqCqqYTajg0bC/myK5+Xgmlaja8afHU6nw1tfbEY5Wk=
X-Google-Smtp-Source: APXvYqwaEy1L8wMO48Bkx6TUX47B66Fi4Ynroe7eX1Z8+ZDSh3qvtgUm424/UjdrlmREf/ClX5HbQa4qxDGqPpj259s=
X-Received: by 2002:a67:fdcf:: with SMTP id l15mr1880vsq.12.1566835660938;
 Mon, 26 Aug 2019 09:07:40 -0700 (PDT)
MIME-Version: 1.0
References: <CAF+90c95GBUbbWUDhP2jW1q9uK3cnEomcwN7xWAup=PhJ0+S1Q@mail.gmail.com>
 <CAF+90c9iSFLKaSXcjhGy3w=ByQDo-rsOuDc1j2dq3AcPkuJGoQ@mail.gmail.com> <98bc53a8-8283-4b70-be76-908574bd3061@www.fastmail.com>
In-Reply-To: <98bc53a8-8283-4b70-be76-908574bd3061@www.fastmail.com>
Date: Mon, 26 Aug 2019 18:07:27 +0200
Message-ID: <CAFPFaMLbSA69C=eCjYycXShiHTbKUPELMdP_-hffXgRhkU=LJA@mail.gmail.com>
To: Ryan McCullagh <me@ryanmccullagh.com>
Cc: PHP internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary="000000000000fde02c0591075ae7"
Subject: Re: [PHP-DEV] Re: Call for participation: Annotating internal
 function argument and return types
From: george.banyard@gmail.com ("G. P. B.")

--000000000000fde02c0591075ae7
Content-Type: text/plain; charset="UTF-8"

On Mon, 26 Aug 2019 at 18:02, Ryan McCullagh <me@ryanmccullagh.com> wrote:

> I would be happy to help annotate the functions from the extensions in the
> Missing list. One question. Should we be using the documentation as the
> source of truth for parameter types, and return values?
>
>
No, the documentation is at times out of sync or doesn't inform about
failure return types, the source of truth is the implementation of these
functions.

Best regards

George P. Banyard

--000000000000fde02c0591075ae7--