Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:99629 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 16768 invoked from network); 23 Jun 2017 19:20:10 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 23 Jun 2017 19:20:10 -0000 Authentication-Results: pb1.pair.com header.from=php@fleshgrinder.com; sender-id=unknown Authentication-Results: pb1.pair.com smtp.mail=php@fleshgrinder.com; spf=permerror; sender-id=unknown Received-SPF: error (pb1.pair.com: domain fleshgrinder.com from 212.232.25.164 cause and error) X-PHP-List-Original-Sender: php@fleshgrinder.com X-Host-Fingerprint: 212.232.25.164 mx208.easyname.com Received: from [212.232.25.164] ([212.232.25.164:37197] helo=mx208.easyname.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 80/B4-12245-8E96D495 for ; Fri, 23 Jun 2017 15:20:08 -0400 Received: from cable-81-173-132-37.netcologne.de ([81.173.132.37] helo=[192.168.178.20]) by mx.easyname.com with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.89) (envelope-from ) id 1dOU7d-0000md-MC; Fri, 23 Jun 2017 19:20:03 +0000 References: <31e715a7-d129-17f0-b870-52bc1ca1715d@fleshgrinder.com> To: php-internals , christopher.jones@oracle.com Message-ID: <76397c50-1bb6-a777-2f72-25a7ed9981dc@fleshgrinder.com> Date: Fri, 23 Jun 2017 21:19:43 +0200 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.2.0 MIME-Version: 1.0 In-Reply-To: Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="2BKOanXMDChLhsF7Eivid96CUNmaAVPMH" X-DNSBL-PBLSPAMHAUS: YES Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen From: php@fleshgrinder.com (Fleshgrinder) --2BKOanXMDChLhsF7Eivid96CUNmaAVPMH Content-Type: multipart/mixed; boundary="6bi7OBQfMsS5vI33vkajPwDcitWkpk0sE"; protected-headers="v1" From: Fleshgrinder To: php-internals , christopher.jones@oracle.com Message-ID: <76397c50-1bb6-a777-2f72-25a7ed9981dc@fleshgrinder.com> Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen References: <31e715a7-d129-17f0-b870-52bc1ca1715d@fleshgrinder.com> In-Reply-To: --6bi7OBQfMsS5vI33vkajPwDcitWkpk0sE Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable On 6/23/2017 5:12 AM, Christopher Jones wrote: > That kind of detail belongs in the RFC. >=20 > A link to existing 'prior art' would have rounded the picture out and l= et > people decide between alternatives of internal vs external doc. > E.g. link to https://wiki.php.net/internals/references >=20 > Also, is this for core and for extensions? Or for core only? What > about PECL extensions not part of the PHP bundle? >=20 > In summary, see point 8 of > https://blogs.oracle.com/opal/the-mysterious-php-rfc-process-and-how-yo= u-can-change-the-web >=20 >=20 > Chris >=20 Hi Chris! I agree and if I would have thought about it, I would have included it. (This is not an excuse, just the honest truth.) I can create a follow up RFC with more detailed rules, or maybe we wait a little so that everybody can get acquainted with Doxygen first. Regarding PECL: I clearly state in the introduction "for the C sources of PHP" (in other words, everything inside the php-src repository) and I would stick to that. PECL authors should be allowed, like Composer authors, to do whatever they want. PECL extensions that are to be included in "the C sources of PHP" should of course adopt the style, like it is already today in regards to the code style. Otherwise we can never get to the "future scope" of actually generating docs for browsing.= --=20 Richard "Fleshgrinder" Fussenegger --6bi7OBQfMsS5vI33vkajPwDcitWkpk0sE-- --2BKOanXMDChLhsF7Eivid96CUNmaAVPMH Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJZTWnZAAoJEOKkKcqFPVVrBeoP/isuB+p5GZ9FzUrr3JMEpvFY Ia3BomoSdKcnfqDmFAa+biJfww27xtk8vxLIP54vcMZeolq/orYkG6u8w2UMbcs0 31tinLBUhToHwQwMKf2jzJWBFoQ60I6r7g7oQPwnuoLwROU/FNNrUyf5ycxa4HKe OtoeuC5IinTKH1dkQVJX4qgG9/95XBqC6qz9UDyGK/p4wSzCwxQEdJxGT7jpLZ9I V7j8outcWWF7ULCWKkaVMTTLdWAXkTyxL/c0up7ugE3f8SbPnPPOLXI7Tn5GLeRS kZl2Lgu5Ga0FJsGPJpyn6zJ/wkV4O66iG64ftYiHHeEIU0/x2J0AY0G1vvK1O9TM 70+kUyHcYFjSBQisCa4pY4VsWYBq/E4O3E7z0uwvLnj5sRSfM3Yw74txd7Y7P1pi Kcxx08osAUgWTWyfAL3BCmBZqIgtykttPpITNAolnehGcvaRgP7vVmanwejYSXSP iQh4A1PxdwqcbadSWDSfe04KUXcXfO3lhmTB4GcQY5iT9XCmtBhF4O2NAbDabXYH ugSnpPNMuuXH6BexryJT7MP5DAY+5Wzw/LY/UtBZSTyIC9EUXIqJPVIj8t2wb6yn I5W5Q1mIMvfBAUIcAC0KW8upiwqPcmnogJcmntw1d4ug4DVEWy33RPQwzymB/x26 VzpN2/rHF/0uyEalzWaF =VTg7 -----END PGP SIGNATURE----- --2BKOanXMDChLhsF7Eivid96CUNmaAVPMH--