Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:99140 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 82261 invoked from network); 24 May 2017 10:33:57 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 24 May 2017 10:33:57 -0000 Authentication-Results: pb1.pair.com smtp.mail=php@fleshgrinder.com; spf=permerror; sender-id=unknown Authentication-Results: pb1.pair.com header.from=php@fleshgrinder.com; sender-id=unknown Received-SPF: error (pb1.pair.com: domain fleshgrinder.com from 77.244.243.83 cause and error) X-PHP-List-Original-Sender: php@fleshgrinder.com X-Host-Fingerprint: 77.244.243.83 mx102.easyname.com Received: from [77.244.243.83] ([77.244.243.83:47886] helo=mx102.easyname.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 63/E7-10292-29165295 for ; Wed, 24 May 2017 06:33:56 -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.84_2) (envelope-from ) id 1dDTbx-0007yT-EC; Wed, 24 May 2017 10:33:51 +0000 To: php-internals Reply-To: php-internals Cc: Nikita Popov Message-ID: Date: Wed, 24 May 2017 12:33:33 +0200 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.1.1 MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="87vKTclNbIIqxPqepUwkJpBolN4w08tgv" X-DNSBL-PBLSPAMHAUS: YES Subject: Documentation (Doxygen) From: php@fleshgrinder.com (Fleshgrinder) --87vKTclNbIIqxPqepUwkJpBolN4w08tgv Content-Type: multipart/mixed; boundary="58jS25i0HmTjQBtAN8hUHEAEnwuvJl1xl"; protected-headers="v1" From: Fleshgrinder Reply-To: php-internals To: php-internals Cc: Nikita Popov Message-ID: Subject: Documentation (Doxygen) --58jS25i0HmTjQBtAN8hUHEAEnwuvJl1xl Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable Hey internals! Nikic recommended that we discuss this topic before my latest PRs can be merged. https://github.com/php/php-src/pull/2523 https://github.com/php/php-src/pull/2535 I used Doxygen in both PRs to document the code. Right now the code base is lacking a lot of documentation, which, if done right, would greatly improve accessibility of the code base. The decision for Doxygen was not really a question of taste or anything, it's just one I know very well for C. I am open to anything, as long as we do something. --=20 Richard "Fleshgrinder" Fussenegger --58jS25i0HmTjQBtAN8hUHEAEnwuvJl1xl-- --87vKTclNbIIqxPqepUwkJpBolN4w08tgv 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 iQIcBAEBCAAGBQJZJWGFAAoJEOKkKcqFPVVrYI4P/AxNxIb0wrWXvLosOEEb0GX2 VpoKV0oREvEzI5p07ggg2HtJzZbeujl2xIhRwxruvxId37rPmgE65wsejqk6Ua3g zrzaqUWVgZQddlKNnVjZWz/lAh5U3li33+jtF60FztDEz7wfN9xAJXVCEx4F1HLo g1Cst66B0RAEFY7c3UrMc2NswYIxiSbpB34Sf7Kn4RfeTJeYealuBn9ALFq4CcOp i/md57JelymOZt69DN87n6kIw6CuC0xOeBsv6mkMouZ0cBI3pOvmNcHDfyV0azGh GWddpUsxQnheqMhEuz5BcS8bhZd5Q8jKR3mTxrauVZd+LY4nCWBqOjRWSzTHC0rt o5OE/iceVeIT79tWgzwWvVSOf3uw91Be77F+bHGQPj/q7mmH46p0wPiJqo62KshK LI/cgimGr9XSWFQHysr8OS1K5zlbntL9BhDqr5Hw3RtgLuGQHA6FKCxKqE4ZKVFZ llsDGr4qMWue2Md0jshcckxxSIrQilJdOtgvz+hBea3UvMBLEg1QFS5wVmM/huM2 U5IWsrDoM6QtnJPjl0EsE1ach/lVQSzO28sF6cfS/dM9jvIPx27L8ihR7cpnaDy+ 9NoJSBAhBK9nMeSlili+r9zdVQWqadFjZjYa1v8pzVMR807NACyCrcTDUL8NqgtO vgSbMEngfrbydRxH1uPB =ylxY -----END PGP SIGNATURE----- --87vKTclNbIIqxPqepUwkJpBolN4w08tgv--