Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-26 Thread Christopher Jones
at 10:59 PM, Anatol Belski <weltl...@outlook.de> wrote: -Original Message- From: Fleshgrinder [mailto:p...@fleshgrinder.com] Sent: Saturday, June 24, 2017 11:34 PM To: php-internals <internals@lists.php.net>; Anatol Belski <weltl...@outlook.de> Subject: Re: [PHP-DEV] [R

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-26 Thread Rasmus Lerdorf
No from me as well. This is wagging the dog by the tail. Picking a documentation format is the very least of the concerns here. It would be wonderful to have better internal API documentation, but putting up any sort of structural restriction like limiting it to a specific header-based format,

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-26 Thread Kalle Sommer Nielsen
HI Joe, 2017-06-26 8:43 GMT+02:00 Joe Watkins : > Morning, > > I also voted no for similar reasons to Anatol. > > This is not really a thing that needs a vote, this is a thing that requires > the handful of people who are actually able to document ZE to spend > considerable

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-26 Thread Joe Watkins
<weltl...@outlook.de> wrote: > > > > -Original Message- > > From: Fleshgrinder [mailto:p...@fleshgrinder.com] > > Sent: Saturday, June 24, 2017 11:34 PM > > To: php-internals <internals@lists.php.net>; Anatol Belski > > <weltl...@outlook.

RE: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-24 Thread Anatol Belski
> -Original Message- > From: Fleshgrinder [mailto:p...@fleshgrinder.com] > Sent: Saturday, June 24, 2017 11:34 PM > To: php-internals <internals@lists.php.net>; Anatol Belski > <weltl...@outlook.de> > Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen > >

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-24 Thread Fleshgrinder
On 6/24/2017 11:28 PM, Anatol Belski wrote: > I voted no, because it is too short term and I'd see a productivity > drop having such an obligation suddenly right in place for 7.2. To > implement the change, there's more than just to put the doc into the > source. Every piece of code needs to be

RE: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-24 Thread Anatol Belski
Hi, > -Original Message- > From: Fleshgrinder [mailto:p...@fleshgrinder.com] > Sent: Friday, June 23, 2017 9:20 PM > To: php-internals <internals@lists.php.net>; christopher.jo...@oracle.com > Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen > > On 6/23/2017 5:12

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-23 Thread Fleshgrinder
On 6/23/2017 5:12 AM, Christopher Jones wrote: > That kind of detail belongs in the RFC. > > A link to existing 'prior art' would have rounded the picture out and let > people decide between alternatives of internal vs external doc. > E.g. link to https://wiki.php.net/internals/references > >

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-22 Thread Christopher Jones
On 22/6/17 1:43 am, Fleshgrinder wrote: On 6/21/2017 5:38 PM, Nikita Popov wrote: Can you please clarify where functions that are declared in a header and defined in a source file should be documented? I believe the usual recommendation is to document in the source file, because it's closer

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-21 Thread Fleshgrinder
On 6/21/2017 5:38 PM, Nikita Popov wrote: > Can you please clarify where functions that are declared in a header and > defined in a source file should be documented? I believe the usual > recommendation is to document in the source file, because it's closer to > the implementation and thus more

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-21 Thread Nikita Popov
On Sat, Jun 17, 2017 at 9:53 AM, Fleshgrinder wrote: > Hi! > > I started voting on the Doxygen RFC: > > https://wiki.php.net/rfc/doxygen > > -- > Richard "Fleshgrinder" Fussenegge > Can you please clarify where functions that are declared in a header and defined in a

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-21 Thread Fleshgrinder
On 6/21/2017 4:13 AM, Christopher Jones wrote: > > On 17/6/17 5:53 pm, Fleshgrinder wrote: >> Hi! >> >> I started voting on the Doxygen RFC: >> >> https://wiki.php.net/rfc/doxygen >> > Did I miss seeing when the vote ends? > > Chris > You did not, I forgot to mention it. The vote will close on

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-21 Thread Fleshgrinder
On 6/19/2017 2:31 PM, Jakub Zelenka wrote: > On Sat, Jun 17, 2017 at 8:53 AM, Fleshgrinder wrote: > >> Hi! >> >> I started voting on the Doxygen RFC: >> >> https://wiki.php.net/rfc/doxygen >> >> > I just wanted to send my feedback and the reason why I voted "yes". First >

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-20 Thread Christopher Jones
On 17/6/17 5:53 pm, Fleshgrinder wrote: Hi! I started voting on the Doxygen RFC: https://wiki.php.net/rfc/doxygen Did I miss seeing when the vote ends? Chris -- http://twitter.com/ghrd -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit:

Re: [PHP-DEV] [RFC] [Vote] Doxygen

2017-06-19 Thread Jakub Zelenka
On Sat, Jun 17, 2017 at 8:53 AM, Fleshgrinder wrote: > Hi! > > I started voting on the Doxygen RFC: > > https://wiki.php.net/rfc/doxygen > > I just wanted to send my feedback and the reason why I voted "yes". First of all I don't really like adding too much documentation

[PHP-DEV] [RFC] [Vote] Doxygen

2017-06-17 Thread Fleshgrinder
Hi! I started voting on the Doxygen RFC: https://wiki.php.net/rfc/doxygen -- Richard "Fleshgrinder" Fussenegger signature.asc Description: OpenPGP digital signature