Newsgroups: php.doc,php.internals Path: news.php.net Xref: news.php.net php.doc:969386554 php.internals:98800 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 4383 invoked from network); 14 Apr 2017 17:47:54 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 14 Apr 2017 17:47:54 -0000 Authentication-Results: pb1.pair.com header.from=philip@roshambo.org; sender-id=unknown Authentication-Results: pb1.pair.com smtp.mail=philip@roshambo.org; spf=permerror; sender-id=unknown Received-SPF: error (pb1.pair.com: domain roshambo.org from 74.125.83.47 cause and error) X-PHP-List-Original-Sender: philip@roshambo.org X-Host-Fingerprint: 74.125.83.47 mail-pg0-f47.google.com Received: from [74.125.83.47] ([74.125.83.47:34678] helo=mail-pg0-f47.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 3B/F6-31410-84B01F85 for ; Fri, 14 Apr 2017 13:47:53 -0400 Received: by mail-pg0-f47.google.com with SMTP id 21so46143857pgg.1 for ; Fri, 14 Apr 2017 10:47:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=roshambo-org.20150623.gappssmtp.com; s=20150623; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=YE6IAjHk/HiYI4b9ZyRyE4ttCi5HrikR+0byeU8X8v4=; b=nFI3/jyuk4hzjLzcqQmALwvXcFaYolSFvjBYSlSJF6hf2vLegqM/aJPdF6DjH5Hy4+ o2tYt0ZWlU9KBkSoBPCx9wHz6E5wPiFA9WdcH7hM+SbRseZCwfueVMFrpUjeMFGo0WJf zeQmXDSNZM1bmMWhb+DDpuquVPsibop1S/Lvf8QaAu/ksgHPOIxDOIiChf8FYRYrThhp W+MYgq44XJdMacOaLfND9O8JgPa6eHjDiqPJ9jdm1fS9Jfb7nLlX2NBfgS1eB68dxzoY KP1tC/a06vU39f1xst7rVgIcmFWevGARjTjHIko7pQ7gcX0hOBusW5Ei91/G2NSDCJrn a9kg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=YE6IAjHk/HiYI4b9ZyRyE4ttCi5HrikR+0byeU8X8v4=; b=ofI6EsVm7vGWyjKJs2UPOOQ7hPdczJ5RxxebxOfFCeWc2b6rEPLwDNFfOSXxDFAO3i lDnDdg1xLXz8i2egkRoca7qTR6EbAd9vii4th85vfUnOMIJdRoRiq/xWzmTe4tnmAYLB Nrpt30PvvcmHO1/Itark8f6OiUukRxLTIPOXU2IlEM8hGN84gBFtU9KbcxNV5JqBYXgM cbK5mXj8viZSk1n/P88nO0jDdmPokQ25bOt0R86op0qPpp60GajuObyPLYR8+xyXeQgL XcDWZUpdpQv0L2GpLCX4YVs9g528ck3ZsKlry6sQhUcCXjC5Q13iViAR1IhhYMPy5Rc1 IE3Q== X-Gm-Message-State: AN3rC/7reoLSiSNSKdO2Nua/c3683zEfGB+Nelw1sGzBVpCf9vMKxm8r A3IUCSlIvStUeQ== X-Received: by 10.98.158.205 with SMTP id f74mr8224982pfk.119.1492192069890; Fri, 14 Apr 2017 10:47:49 -0700 (PDT) Received: from [192.168.7.23] (c-73-25-103-244.hsd1.or.comcast.net. [73.25.103.244]) by smtp.gmail.com with ESMTPSA id 12sm4407382pgb.35.2017.04.14.10.47.48 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 14 Apr 2017 10:47:49 -0700 (PDT) Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) In-Reply-To: <690015854.1384408.1492163148986.JavaMail.zimbra@pieterhordijk.com> Date: Fri, 14 Apr 2017 10:47:48 -0700 Cc: yohgaki@ohgaki.net, Joe Watkins , Andrey Andreev , internals , phpdoc , nikita.ppv@gmail.com Content-Transfer-Encoding: 7bit Message-ID: <9939FD2A-9E56-4E0E-9AAC-014FA00FEA84@roshambo.org> References: <1924612862.1298112.1492071094545.JavaMail.zimbra@pieterhordijk.com> <690015854.1384408.1492163148986.JavaMail.zimbra@pieterhordijk.com> To: Pieter Hordijk X-Mailer: Apple Mail (2.3273) Subject: Re: [PHP-DOC] [PHP-DEV] [RFC][VOTE] Improve hash_hkdf() parameter From: philip@roshambo.org (Philip Olson) Hello, The PHP documentation has a separate place for detailed examples. For example: http://php.net/manual/en/book.inclued.php http://php.net/manual/en/inclued.examples-implementation.php The same could be done for ext/hash which today lacks an Examples section: http://php.net/manual/en/book.hash.php This way the function's docs (hash_hkdf() in this case) remain as reference material while detailed examples live elsewhere. Regards, Philip