Re: [PHP-DOC] SVN Account Request: shein
2010/10/25 Philip Olson phi...@roshambo.org: On Oct 25, 2010, at 10:28 AM, Shein Alexey wrote: Replacing c...@php.net account. Greetings Shein, This move has been completed, and you now have full phpdoc karma so you won't have to post doc-base/* patches anymore... ;) Regards, Philip Just tried now and it seems I can't login neither with old nor with new account. -- Regards, Shein Alexey
Re: [PHP-DOC] Doc for Pecl PHP Judy
On 26 October 2010 13:02, Richard Quadling rquadl...@gmail.com wrote: On 25 October 2010 19:48, Nicolas Brousse nico...@brousse.info wrote: Thanks Philip for the feedback. I started to do all the clean up you suggested. I will continue to document later tonight. On Mon, Oct 25, 2010 at 9:51 AM, Philip Olson phi...@roshambo.org wrote: On Oct 24, 2010, at 5:00 PM, Nicolas Brousse wrote: Hi, Last month I did a php binding for the libJudy, It's in pecl, I also started to do the doc, you can find it here : http://svn.php.net/viewvc/pecl/judy/trunk/doc/ Is there any requirement to get this on the site ? Should I commit the chunked xhtml version ? Btw, I could do the doc in English and French if needed. Greetings Nicolas, Please commit the XML as we generate the HTML every week. Also it looks good but a few minor notes: - Please fix the whitespace. One space, no tabs, and lines should be around 80 characters although not a major deal (just not 200... ;) - Don't commit entities.* files or book.developer.xml - Please change the ReturnType and Description place holders before committing - And please update the versions.xml before committing Then, commit as phpdoc/en/trunk/reference/judy/, and the doc-base/manual.xml.in change. Excellent :) Regards, Philip The Installation page for Judy [1] says ... There is no installation needed to use these functions; they are part of the PHP core. I thought Judy is PECL extension and not part of core (at least not in the 5.3 branch [2] or trunk [3]), and as such, the expected xml would be ... section xml:id=judy.installation reftitle.install; para pecl.info; link xlink:href=url.pecl.package;judyurl.pecl.package;judy/link /para /section Richard. [1] http://docs.php.net/manual/en/judy.installation.php [2] http://svn.php.net/viewvc/php/php-src/branches/PHP_5_3/ext/ [3] http://svn.php.net/viewvc/php/php-src/trunk/ext/ OOI, is there any chance of having libJudy available via http://pecl2.php.net/downloads/php-windows-builds/php-libs Richard. -- Richard Quadling Twitter : EE : Zend @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY
Re: [PHP-DOC] Doc for Pecl PHP Judy
On 26 October 2010 13:14, Richard Quadling rquadl...@gmail.com wrote: On 26 October 2010 13:02, Richard Quadling rquadl...@gmail.com wrote: On 25 October 2010 19:48, Nicolas Brousse nico...@brousse.info wrote: Thanks Philip for the feedback. I started to do all the clean up you suggested. I will continue to document later tonight. On Mon, Oct 25, 2010 at 9:51 AM, Philip Olson phi...@roshambo.org wrote: On Oct 24, 2010, at 5:00 PM, Nicolas Brousse wrote: Hi, Last month I did a php binding for the libJudy, It's in pecl, I also started to do the doc, you can find it here : http://svn.php.net/viewvc/pecl/judy/trunk/doc/ Is there any requirement to get this on the site ? Should I commit the chunked xhtml version ? Btw, I could do the doc in English and French if needed. Greetings Nicolas, Please commit the XML as we generate the HTML every week. Also it looks good but a few minor notes: - Please fix the whitespace. One space, no tabs, and lines should be around 80 characters although not a major deal (just not 200... ;) - Don't commit entities.* files or book.developer.xml - Please change the ReturnType and Description place holders before committing - And please update the versions.xml before committing Then, commit as phpdoc/en/trunk/reference/judy/, and the doc-base/manual.xml.in change. Excellent :) Regards, Philip The Installation page for Judy [1] says ... There is no installation needed to use these functions; they are part of the PHP core. I thought Judy is PECL extension and not part of core (at least not in the 5.3 branch [2] or trunk [3]), and as such, the expected xml would be ... section xml:id=judy.installation reftitle.install; para pecl.info; link xlink:href=url.pecl.package;judyurl.pecl.package;judy/link /para /section Richard. [1] http://docs.php.net/manual/en/judy.installation.php [2] http://svn.php.net/viewvc/php/php-src/branches/PHP_5_3/ext/ [3] http://svn.php.net/viewvc/php/php-src/trunk/ext/ OOI, is there any chance of having libJudy available via http://pecl2.php.net/downloads/php-windows-builds/php-libs Richard. And as I'm on a roll, could http://wiki.php.net/internals/windows/libs be updated too? -- Richard Quadling Twitter : EE : Zend @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY
Re: [PHP-DOC] Doc for Pecl PHP Judy
On 25 October 2010 19:48, Nicolas Brousse nico...@brousse.info wrote: Thanks Philip for the feedback. I started to do all the clean up you suggested. I will continue to document later tonight. On Mon, Oct 25, 2010 at 9:51 AM, Philip Olson phi...@roshambo.org wrote: On Oct 24, 2010, at 5:00 PM, Nicolas Brousse wrote: Hi, Last month I did a php binding for the libJudy, It's in pecl, I also started to do the doc, you can find it here : http://svn.php.net/viewvc/pecl/judy/trunk/doc/ Is there any requirement to get this on the site ? Should I commit the chunked xhtml version ? Btw, I could do the doc in English and French if needed. Greetings Nicolas, Please commit the XML as we generate the HTML every week. Also it looks good but a few minor notes: - Please fix the whitespace. One space, no tabs, and lines should be around 80 characters although not a major deal (just not 200... ;) - Don't commit entities.* files or book.developer.xml - Please change the ReturnType and Description place holders before committing - And please update the versions.xml before committing Then, commit as phpdoc/en/trunk/reference/judy/, and the doc-base/manual.xml.in change. Excellent :) Regards, Philip The Installation page for Judy [1] says ... There is no installation needed to use these functions; they are part of the PHP core. I thought Judy is PECL extension and not part of core (at least not in the 5.3 branch [2] or trunk [3]), and as such, the expected xml would be ... section xml:id=judy.installation reftitle.install; para pecl.info; link xlink:href=url.pecl.package;judyurl.pecl.package;judy/link /para /section Richard. [1] http://docs.php.net/manual/en/judy.installation.php [2] http://svn.php.net/viewvc/php/php-src/branches/PHP_5_3/ext/ [3] http://svn.php.net/viewvc/php/php-src/trunk/ext/ -- Richard Quadling Twitter : EE : Zend @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY
Re: [PHP-DOC] Doc for Pecl PHP Judy
Hmm, I messed up something... :/ There is definitely some installation step, there is a configure.xml in the doc. I probably did a wrong link somewhere, I will take a look later today. On Tue, Oct 26, 2010 at 5:02 AM, Richard Quadling rquadl...@gmail.com wrote: On 25 October 2010 19:48, Nicolas Brousse nico...@brousse.info wrote: Thanks Philip for the feedback. I started to do all the clean up you suggested. I will continue to document later tonight. On Mon, Oct 25, 2010 at 9:51 AM, Philip Olson phi...@roshambo.org wrote: On Oct 24, 2010, at 5:00 PM, Nicolas Brousse wrote: Hi, Last month I did a php binding for the libJudy, It's in pecl, I also started to do the doc, you can find it here : http://svn.php.net/viewvc/pecl/judy/trunk/doc/ Is there any requirement to get this on the site ? Should I commit the chunked xhtml version ? Btw, I could do the doc in English and French if needed. Greetings Nicolas, Please commit the XML as we generate the HTML every week. Also it looks good but a few minor notes: - Please fix the whitespace. One space, no tabs, and lines should be around 80 characters although not a major deal (just not 200... ;) - Don't commit entities.* files or book.developer.xml - Please change the ReturnType and Description place holders before committing - And please update the versions.xml before committing Then, commit as phpdoc/en/trunk/reference/judy/, and the doc-base/manual.xml.in change. Excellent :) Regards, Philip The Installation page for Judy [1] says ... There is no installation needed to use these functions; they are part of the PHP core. I thought Judy is PECL extension and not part of core (at least not in the 5.3 branch [2] or trunk [3]), and as such, the expected xml would be ... section xml:id=judy.installation reftitle.install; para pecl.info; link xlink:href=url.pecl.package;judyurl.pecl.package;judy/link /para /section Richard. [1] http://docs.php.net/manual/en/judy.installation.php [2] http://svn.php.net/viewvc/php/php-src/branches/PHP_5_3/ext/ [3] http://svn.php.net/viewvc/php/php-src/trunk/ext/ -- Richard Quadling Twitter : EE : Zend @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY
Re: [PHP-DOC] License for code examples in the PHP manual?
On Mon, Oct 11, 2010 at 4:34 PM, Robinson Tryon bishop.robin...@gmail.com wrote: On Mon, Oct 11, 2010 at 4:07 PM, Philip Olson phi...@roshambo.org wrote: I avoid the topic of licenses whenever possible but let's make a decision. It feels like most would prefer dual licensing for code snippets (despite GPL and PHP not getting along all that well, ever) so let's do that. Does someone here have a lawyer friend who will look over the proposed change? Sure, I'm happy to take point on that. I'll pass along the information from this thread and let the list know as soon as I hear something back from the lawyers. Hi guys, I've heard back from the lawyers and received some very helpful information about dual-licensing the documentation and dealing with copyright assignment. (General disclaimer: IANAL, and this advice should be construed as nothing more than my advice) Based on my conversations, here's a licensing paragraph that can be used on the PHP licensing page (and on individual pages of the manual, if desired): The PHP manual is Copyright (C) the PHP Documentation Group, and is released under the Creative Commons Attribution 3.0 License. All example code in the documentation or freely submitted by the public in user notes is additionally licensed under the New BSD License. Regarding copyright assignment, it appears that the law is quite strict about the matter, requiring actual signatures from individuals to complete the transfer. That kind of requirement seems like enough hassle than it might discourage people from contributing user notes, which is definitely something that we all want to avoid. But don't get discouraged yet! Based on what I've heard from the lawyers, we don't necessarily need copyright assignment to include user notes in the manual. Instead of requiring assignment, we can just require a license from the individual to the PHP Documentation Group. Here's a draft of how the ToS could read: To improve the PHP Manual, information from user notes may be periodically incorporated into the primary documentation. By submitting a user note you attest that all contributions are your own and grant the PHP Documentation Group a license to use the content of the user note in the documentation under the same terms as the primary documentation, as well as the right to re-license the content should the license of the PHP Manual change. Content that violates any copyrights will be deleted. See the Licensing Page for details. On a related note, is there any further clarification about who comprises The PHP Documentation Group ? It might be helpful to get that sorted out at the same time as the dual-licensing of the documentation, particularly as the documentation license specifically refers to the Group, and they appear to hold the role of shepherds of the manual, user notes, and license. Cheers, -- Robinson
Re: [PHP-DOC] Doc for Pecl PHP Judy
I just commited a fix to the doc. I will update the wiki too. On Tue, Oct 26, 2010 at 9:12 AM, Nicolas Brousse nico...@brousse.info wrote: Hmm, I messed up something... :/ There is definitely some installation step, there is a configure.xml in the doc. I probably did a wrong link somewhere, I will take a look later today. On Tue, Oct 26, 2010 at 5:02 AM, Richard Quadling rquadl...@gmail.com wrote: On 25 October 2010 19:48, Nicolas Brousse nico...@brousse.info wrote: Thanks Philip for the feedback. I started to do all the clean up you suggested. I will continue to document later tonight. On Mon, Oct 25, 2010 at 9:51 AM, Philip Olson phi...@roshambo.org wrote: On Oct 24, 2010, at 5:00 PM, Nicolas Brousse wrote: Hi, Last month I did a php binding for the libJudy, It's in pecl, I also started to do the doc, you can find it here : http://svn.php.net/viewvc/pecl/judy/trunk/doc/ Is there any requirement to get this on the site ? Should I commit the chunked xhtml version ? Btw, I could do the doc in English and French if needed. Greetings Nicolas, Please commit the XML as we generate the HTML every week. Also it looks good but a few minor notes: - Please fix the whitespace. One space, no tabs, and lines should be around 80 characters although not a major deal (just not 200... ;) - Don't commit entities.* files or book.developer.xml - Please change the ReturnType and Description place holders before committing - And please update the versions.xml before committing Then, commit as phpdoc/en/trunk/reference/judy/, and the doc-base/manual.xml.in change. Excellent :) Regards, Philip The Installation page for Judy [1] says ... There is no installation needed to use these functions; they are part of the PHP core. I thought Judy is PECL extension and not part of core (at least not in the 5.3 branch [2] or trunk [3]), and as such, the expected xml would be ... section xml:id=judy.installation reftitle.install; para pecl.info; link xlink:href=url.pecl.package;judyurl.pecl.package;judy/link /para /section Richard. [1] http://docs.php.net/manual/en/judy.installation.php [2] http://svn.php.net/viewvc/php/php-src/branches/PHP_5_3/ext/ [3] http://svn.php.net/viewvc/php/php-src/trunk/ext/ -- Richard Quadling Twitter : EE : Zend @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY