Re: [PHP-DOC] License for code examples in the PHP manual?

2010-10-04 Thread Brandon Savage
On Mon, Oct 4, 2010 at 7:24 AM, Hannes Magnusson wrote: > On Mon, Oct 4, 2010 at 12:08, Robinson Tryon > wrote: > > It shouldn't take too long to fix this -- I'd just add a note in the > > documentation section of the PHP license page along the lines of "All > > example code in the PHP manual, i

Re: [PHP-DOC] License for code examples in the PHP manual?

2010-10-04 Thread Brandon Savage
> > The "snippet's owner(s)" is the PHP Documentation Group. > The CC-BY license has this explicit notice (in human readable terms): > "Attribution — You must attribute the work in the manner specified by > the author or licensor (but not in any way that suggests that they > endorse you or your use

[PHP-DOC] Questions about ob_start() documentation

2010-03-30 Thread Brandon Savage
I was looking for documentation today regarding ob_start(), and I noticed that under the changelog the following is stated: 6.0.0 Value 1 is no more special. This clearly isn't grammatically correct, and doesn't communicate very well what, if any, changes are being made to the ob_start() function

Re: [PHP-DOC] __autoload() and exceptions

2009-11-20 Thread Brandon Savage
On Nov 20, 2009, at 3:05 PM, Hannes Magnusson wrote: > On Fri, Nov 20, 2009 at 20:51, Brandon Savage > wrote: >> All, >> >> I was playing around today with the autoload functions and I discovered that >> in PHP 5.3, __autoload() can throw, and scripts can ca

[PHP-DOC] __autoload() and exceptions

2009-11-20 Thread Brandon Savage
All, I was playing around today with the autoload functions and I discovered that in PHP 5.3, __autoload() can throw, and scripts can catch, exceptions. This is in direct contradiction to the documentation: http://php.net/manual/en/language.oop5.autoload.php I have filed a bug report with the

Re: [PHP-DOC] Doc Build Error

2009-09-29 Thread Brandon Savage
I'm getting it too. I did an SVN blame command and the user who last changed that line appears to be rquadling in r288937. I fixed the missing tag, which allowed me to compile the manual. I committed my change. Update and try again. Brandon On Tue, Sep 29, 2009 at 12:33 PM, Anthony Bedford wrot

Re: [PHP-DOC] PHP 4 Documentation Moved To Appendix

2009-09-23 Thread Brandon Savage
On Wed, Sep 23, 2009 at 11:38 AM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > On Wed, Sep 23, 2009 at 16:16, Brandon Savage > wrote: > > All, > > > > For those of you not on the commit list, I went ahead and moved the PHP 4 > > OOP documentation t

[PHP-DOC] PHP 4 Documentation Moved To Appendix

2009-09-23 Thread Brandon Savage
All, For those of you not on the commit list, I went ahead and moved the PHP 4 OOP documentation to the appendix. This is a reflection of the discussion we had where it was expressed that the PHP 5 OOP documentation should be perceived and treated as the only documentation for PHP's object model.

[PHP-DOC] Inheritance in PHP 5 Documentation

2009-09-17 Thread Brandon Savage
All, I was taking a look today at the documentation for PHP 5's object model, and there is nothing that discusses inheritance or the ability to override methods in subclasses. I realize this is a part of the basics of object oriented programming and certainly not unique to PHP; however, I was thin

[PHP-DOC] Changing Password

2009-09-14 Thread Brandon Savage
All, Is there a way to change the SVN account password? I'd like to change my password, but without sending a plaintext representation of it to someone for manual adjustment. Thanks, Brandon

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-09 Thread Brandon Savage
On Wed, Sep 9, 2009 at 9:35 AM, Brandon Savage wrote: > > > On Wed, Sep 9, 2009 at 9:31 AM, G. T. Stresen-Reuter < > tedmaster...@gmail.com> wrote: > >> >> On Sep 9, 2009, at 2:02 PM, Hannes Magnusson wrote: >> >> On Wed, Sep 9, 2009 at 1

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-09 Thread Brandon Savage
On Wed, Sep 9, 2009 at 9:31 AM, G. T. Stresen-Reuter wrote: > > On Sep 9, 2009, at 2:02 PM, Hannes Magnusson wrote: > > On Wed, Sep 9, 2009 at 13:20, Brandon Savage >> wrote: >> >>> This documentation already exists in that section. >>> >&g

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-09 Thread Brandon Savage
e object itself. Passing objects by reference is no longer necessary. See Objects and References." Brandon On Wed, Sep 9, 2009 at 3:54 AM, Hannes Magnusson wrote: > On Wed, Sep 9, 2009 at 01:29, Brandon Savage > wrote: > > However, each spot where the documentation sta

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-08 Thread Brandon Savage
On Sep 8, 2009, at 6:12 PM, Daniel Convissor wrote: Hi Brandon: Nice stuff. Two qualms with the following: PHP 5's object model also significantly changes the way objects are passed, passing a pointer to the object rather than copying the object. First, "passed" is the followed imme

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-08 Thread Brandon Savage
I'll see what I can do to submit a patch tonight containing new language for a "Differences Between PHP 4 and PHP 5" section. This is outlined to some degree in the "Migrating" documentation, but I still think it's a good idea. Does anyone know what we have to do in order to move the PHP 4

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-08 Thread Brandon Savage
On Sep 8, 2009, at 5:08 PM, Lars Torben Wilson wrote: Brandon Savage wrote: On Sep 8, 2009, at 2:00 AM, Lars Torben Wilson wrote: Philip Olson wrote: Comments, criticisms, and feedback greatly appreciated! Sounds reasonable, and the more information the better :) And while doing this, it&#

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-08 Thread Brandon Savage
on. I think the work you've done is great, and +1 from me on committing the changes. Best, Brandon On Mon, Sep 7, 2009 at 2:30 PM, Lars Torben Wilson wrote: > Brandon Savage wrote: > >> On Sep 7, 2009, at 3:47 AM, Lars Torben Wilson wrote: >> >> Hi all, >>>

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-08 Thread Brandon Savage
On Sep 8, 2009, at 2:00 AM, Lars Torben Wilson wrote: Philip Olson wrote: Comments, criticisms, and feedback greatly appreciated! Sounds reasonable, and the more information the better :) And while doing this, it's probably worth thinking about how to ensure oop5 is a first class citizen. M

Re: [PHP-DOC] oop5 basic rewrite informal RFC

2009-09-07 Thread Brandon Savage
On Sep 7, 2009, at 3:47 AM, Lars Torben Wilson wrote: Hi all, While going through some bug reports I realized that the 'The Basics' section of the PHP 5 classes and objects section, as it stands, could use some attention. I've been going over it and and have rewritten much of it to be mor

Re: [PHP-DOC] Include documentation updates

2009-08-11 Thread Brandon Savage
On Aug 11, 2009, at 8:35 PM, Niel Archer wrote: All, After reviewing the to-do items I saw that the include() documentation needed to be updated. I took a stab at simplifying the first few paragraphs which mostly involved removing verbose text and simplifying. Since the change is fairly sig

Re: [PHP-DOC] Include documentation updates

2009-08-11 Thread Brandon Savage
On Aug 11, 2009, at 8:06 PM, Philip Olson wrote: On Aug 11, 2009, at 4:45 PM, Brandon Savage wrote: All, After reviewing the to-do items I saw that the include() documentation needed to be updated. I took a stab at simplifying the first few paragraphs which mostly involved removing

[PHP-DOC] Include documentation updates

2009-08-11 Thread Brandon Savage
All, After reviewing the to-do items I saw that the include() documentation needed to be updated. I took a stab at simplifying the first few paragraphs which mostly involved removing verbose text and simplifying. Since the change is fairly significant I wanted to solicit feedback from the

Re: [PHP-DOC] CVS Account Request: brandon

2009-08-03 Thread Brandon Savage
On Thu, Jul 30, 2009 at 11:29 AM, Brandon Savage wrote: > Maintaining the documentation > *bump* Has anything happened with this thus far?

[PHP-DOC] CVS Account Request: brandon

2009-07-30 Thread Brandon Savage
Maintaining the documentation

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-30 Thread Brandon Savage
On Thu, Jul 30, 2009 at 10:33 AM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > On Thu, Jul 30, 2009 at 13:28, Brandon Savage > wrote: > >> > >> 2009/7/28 Brandon Savage : > >> > > >> > On Jul 28, 2009, at 4:17 AM, Hannes Magnusso

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-30 Thread Brandon Savage
On Tue, Jul 28, 2009 at 6:12 AM, Peter Cowburn wrote: > 2009/7/28 Brandon Savage : > > > > On Jul 28, 2009, at 4:17 AM, Hannes Magnusson wrote: > > > >> On Tue, Jul 28, 2009 at 01:30, Brandon Savage > > >> wrote: > >>> > >>&g

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-28 Thread Brandon Savage
On Jul 28, 2009, at 4:17 AM, Hannes Magnusson wrote: On Tue, Jul 28, 2009 at 01:30, Brandon Savage> wrote: I spent a bit going over the wording with someone else before I submitted it. According to what I understand, it creates a stack, but doesn't behave in the way a stack does

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-27 Thread Brandon Savage
On Jul 27, 2009, at 8:08 AM, Peter Cowburn wrote: 2009/7/27 Brandon Savage : On Mon, Jul 27, 2009 at 7:43 AM, Hannes Magnusson wrote: On Mon, Jul 27, 2009 at 13:36, Brandon Savage> wrote: On Mon, Jul 27, 2009 at 7:28 AM, Hannes Magnusson wrote: Don't top-post. On Mon

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-27 Thread Brandon Savage
On Mon, Jul 27, 2009 at 7:43 AM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > On Mon, Jul 27, 2009 at 13:36, Brandon Savage > wrote: > > > > > > On Mon, Jul 27, 2009 at 7:28 AM, Hannes Magnusson > > wrote: > >> > >> Don't

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-27 Thread Brandon Savage
On Mon, Jul 27, 2009 at 7:28 AM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > Don't top-post. > > On Mon, Jul 27, 2009 at 13:24, Brandon Savage > wrote: > > > > On Mon, Jul 27, 2009 at 7:21 AM, Hannes Magnusson > > wrote: > >> > &

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-27 Thread Brandon Savage
Done. Can we make a comprehensive list of anything else that's wrong so we can avoid the back-and-forth? On Mon, Jul 27, 2009 at 7:21 AM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > Don't top-post :) > > On Mon, Jul 27, 2009 at 13:14, Brandon Savage > w

Re: [PHP-DOC] SPL Autoload Register Patch

2009-07-27 Thread Brandon Savage
I fixed those issues. Let me know if there are any others. On Mon, Jul 27, 2009 at 3:39 AM, Hannes Magnusson < hannes.magnus...@gmail.com> wrote: > On Sat, Jul 25, 2009 at 18:59, Brandon Savage > wrote: > > This is my first time submitting a patch, but I was asked to add to the

[PHP-DOC] SPL Autoload Register Patch

2009-07-25 Thread Brandon Savage
This is my first time submitting a patch, but I was asked to add to the documentation and so here goes. Please let me know if I did anything incorrectly. Thanks, Brandon spl-autoload-register.diff Description: Binary data

Re: [PHP-DOC] "ezmlm warning" why

2009-06-04 Thread Brandon Savage
There was some sort of illegal attachment sent. It was probably rejected by most servers and thus re ping to see if the email address was dead. That's my best guess. Sent from my iPhone On Jun 4, 2009, at 12:14 PM, Philip Olson wrote: On Jun 4, 2009, at 9:06 AM, pedram salehpoor wrote:

Re: [PHP-DOC] Career In Online Marketing Available

2009-02-05 Thread Brandon Savage
Is this like, spam day on the list? Is there no way to require the first email from these bozos to be approved before they can email all of us? 2009/2/5 Salome Harrold > Hi, > > We are recruiting motivated individuals for participating in well-paying > online surveys, focus groups and previewin

Re: [PHP-DOC] PHP Manual License

2009-01-05 Thread Brandon Savage
Chris, The copyright appears on all php.net pages, which leads me to believe that the website itself is copyrighted with all rights reserved. I downloaded a copy of the manual, and it is distributed with the following: "Copyright (c) 1997 - 2009 by the PHP Documentation Group. This material may

[PHP-DOC] Namespaces Documentation Incorrect?

2008-12-04 Thread Brandon Savage
All, Tony Bibbs pointed this out on Twitter, that it appears the code sample in this documentation is incorrect: http://www.php.net/manual/en/language.namespaces.nested.php Note that the namespaces should be MyProject\Sub\Level but we've got it defined as MyProjectSubLevel in the namespace decla

Re: [PHP-DOC] PDO Documentation

2008-11-26 Thread Brandon Savage
Ok bug submitted. On Wed, Nov 26, 2008 at 1:17 PM, Daniel Brown <[EMAIL PROTECTED]> wrote: > On Wed, Nov 26, 2008 at 1:15 PM, Brandon Savage > <[EMAIL PROTECTED]> wrote: > > Aha. I didn't know there was a process. > > > > I shall submit that bug right

Re: [PHP-DOC] PDO Documentation

2008-11-26 Thread Brandon Savage
Aha. I didn't know there was a process. I shall submit that bug right now. And slap my hand for speaking out of turn. ;-) On Wed, Nov 26, 2008 at 1:14 PM, Daniel Brown <[EMAIL PROTECTED]> wrote: > On Wed, Nov 26, 2008 at 1:06 PM, Brandon Savage > <[EMAIL PROTECTED

[PHP-DOC] PDO Documentation

2008-11-26 Thread Brandon Savage
On the Transactions documentation ( http://us.php.net/manual/en/pdo.transactions.php), the final line of the documentation reads: "In truth, this isn't 100% correct, but it is a good-enough introduction, if you've never heard of transactions before." Can this be changed to read something, anythin

Re: [PHP-DOC] Remove delete()

2008-11-26 Thread Brandon Savage
Absolutely not. delete() is how I found out about unlink() in the first place when I was a newbie developer. IDEs that use the PHP documentation may highlight it as a function, but that's poor work on their part, not on the documentation. My 0.02. Brandon 2008/11/26 Jakub Vrána <[EMAIL PROTECT

Re: [PHP-DOC] Re: Documenting Exceptions

2008-10-03 Thread Brandon Savage
itself. Brandon On Fri, Oct 3, 2008 at 11:13 AM, Philip Olson <[EMAIL PROTECTED]> wrote: > > On 3 Oct 2008, at 06:42, Brandon Savage wrote: > > Hannes et. al., >> >> I took 15 minutes (I actually took 20), read the documentation, installed >> the PEAR package

[PHP-DOC] Re: Documenting Exceptions

2008-10-03 Thread Brandon Savage
Hannes et. al., I took 15 minutes (I actually took 20), read the documentation, installed the PEAR package and followed the directions. But I wasn't able to finish the task in the time you gave me. Some of the challenges: I'm using a Mac and the PEAR package gave me some trouble. Once I resolved

Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead?

2008-10-01 Thread Brandon Savage
I'd be happy to serve as your test subject. I'll post back here when I've done it (sometime this evening once I'm home from the office). Brandon On Wed, Oct 1, 2008 at 4:01 PM, Hannes Magnusson <[EMAIL PROTECTED] > wrote: > On Wed, Oct 1, 2008 at 21:27, Bra

Re: [PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead?

2008-10-01 Thread Brandon Savage
All, I am what I guess you'd call a "newbie" - Elizabeth got me on this list during ZendCon and though I've been following it I still have no idea how the doc editing process works. I'm exactly who you want this kind of tool for - a new contributor who is eager to contribute but unsure about how t