Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:99376 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 25989 invoked from network); 5 Jun 2017 18:57:01 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 5 Jun 2017 18:57:01 -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 77.244.243.85 cause and error) X-PHP-List-Original-Sender: php@fleshgrinder.com X-Host-Fingerprint: 77.244.243.85 mx104.easyname.com Received: from [77.244.243.85] ([77.244.243.85:37251] helo=mx104.easyname.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 8D/95-27119-B79A5395 for ; Mon, 05 Jun 2017 14:57:00 -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 1dHxBP-0004SH-6F; Mon, 05 Jun 2017 18:56:57 +0000 References: <0194b13c-4d68-8e20-b125-6e2f5539e077@fleshgrinder.com> To: php-internals , jgmdev@gmail.com Message-ID: <92496caa-ba17-9711-58be-cf20398bc003@fleshgrinder.com> Date: Mon, 5 Jun 2017 20:56:47 +0200 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.1.1 MIME-Version: 1.0 In-Reply-To: Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="5GD2ftBkshcRWBh3Q24UkGq68dutm9kEj" X-DNSBL-PBLSPAMHAUS: YES Subject: Re: [PHP-DEV] Re: [RFC] [Discussion] Doxygen From: php@fleshgrinder.com (Fleshgrinder) --5GD2ftBkshcRWBh3Q24UkGq68dutm9kEj Content-Type: multipart/mixed; boundary="G7l8C3JnsQE192JJ3Fkpj09Fall6VGnjW"; protected-headers="v1" From: Fleshgrinder To: php-internals , jgmdev@gmail.com Message-ID: <92496caa-ba17-9711-58be-cf20398bc003@fleshgrinder.com> Subject: Re: [PHP-DEV] Re: [RFC] [Discussion] Doxygen References: <0194b13c-4d68-8e20-b125-6e2f5539e077@fleshgrinder.com> In-Reply-To: --G7l8C3JnsQE192JJ3Fkpj09Fall6VGnjW Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable Hey Jefferson! On 6/5/2017 8:40 PM, Jefferson Gonzalez wrote: > First, thanks for taking the initiative to do this! >=20 :) On 6/5/2017 8:40 PM, Jefferson Gonzalez wrote: > Second, the rfc doesn't touch the ability of grouping that doxygen > provides which could be really useful in order to navigate the > documentation more easily. For example: grouping functions related to > the manipulation of zvals in groups like: Objects, Strings, Numbers, > etc... More about this: > http://www.stack.nl/~dimitri/doxygen/manual/grouping.html > and this is some example of how it may look like: > http://docs.wxwidgets.org/trunk/modules.html >=20 Do you have Wiki access? You could explain this feature there. Or maybe send me a write-up directly and I add it. :) On 6/5/2017 8:40 PM, Jefferson Gonzalez wrote: > Third, maybe you can add 2 vote choices in which to document the source= > code in case one is favored more than another. One to document the core= > directly and another method using the interface directory that I > mentioned in my previous e-mail. >=20 The problem I have with this approach is that we have to maintain two header files. One is already total overkill in my book (luckily other languages have learned from this). On 6/5/2017 8:40 PM, Jefferson Gonzalez wrote: > Finally, you mentioned on the RFC that I didn't got any support which > could sound harsh... but what I wrote on the e-mail was that I lost > motivation due to my day/night job, that was the real reason I did not > continued the work with it. >=20 I actually wanted it to sound dramatic, but will change it to the real reason. ;) --=20 Richard "Fleshgrinder" Fussenegger --G7l8C3JnsQE192JJ3Fkpj09Fall6VGnjW-- --5GD2ftBkshcRWBh3Q24UkGq68dutm9kEj 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 iQIcBAEBCAAGBQJZNalvAAoJEOKkKcqFPVVr2OAQAMsNNNjWcCW8gg4LwgRl+NMq GrmcPjzWwwfpvTOdGa7iizOATonkmfb8XyfmSO0lGzON2+PiJc+iZ8UIBUMA31sY 2NWtosPeqjohmaBUUvbX0Gj3DPCHuLsuT8R8uwcAwP0aq3qxzJ0XJlzdns9XkVAA X7bJqY4JkoYhYMHsVZIpC28rdX1viYhi80390nPbDkklP7ZmF5ebMz46y/hCg+YP FIOajFNiBcyfEUKbV2NQPAM6/8b30OiOJ6JL5HyUWCktEq2iUeaWBNcVwxhxMSYq 0SvaJvD30A8EFrxOhbI+IYG34SB5ulMZBu3RV7qwiCPODs/4PQ8yl4yftsLrJI8j iLGt/iLCAHuX2Js1fy7OzWTnTcu1QYpDfjGSGma8ZsZ27EGUCf9Nk1l9/shccl3a q6MUUsUaAXeLshDw3tvbyN7OO8S+khssqUjiYjuyK7SQ2rRdNDyXBB5APUUaCLVX D1DqT81yGy14z+4soid4jSEzuObuD+WXN2a9YdTfPmdDgGuTqDm+OafqZ8sMQNRr v7/1C9Cp/tz0PhZ+G8ZcLxaxHe6SdJIGFQbFUI1/NuxEhLmfWb+QhtpFG/2PpTHq 8Zls4+iNTie5Jit3XgATWNkAS5Hc8Zr828mINS1OlM7c6eB+6ZSwxTlcvEjW+7lX R3V5pSJAS2ksnzokbyx+ =koD9 -----END PGP SIGNATURE----- --5GD2ftBkshcRWBh3Q24UkGq68dutm9kEj--