Re: [PHP-DOC] Re: [PHP-WEBMASTER] [PHP Wiki] new user: antz29

2008-11-26 Thread Richard Quadling
2008/11/26 Lukas Kahwe Smith [EMAIL PROTECTED]: On 26.11.2008, at 09:07, John Le Drew wrote: Hi Lukas I was talking to Steph over the weekend and wanted to put together a set of tutorials + examples for many of the features of PHP, starting with SPL. I thought that the Wiki would be a

Re: [PHP-DOC] Re: [PHP-WEBMASTER] [PHP Wiki] new user: antz29

2008-11-26 Thread John Le Drew
Thanks Richard Downloading the docs now :) Where is a decent place to start putting my tutorials? I really wanted to create decent use cases and examples for SPL, as so many people know of it, but have no idea how or why they would implement it. Cheers John 2008/11/26 Richard Quadling

[PHP-DOC] Re: [PHP-WEBMASTER] [PHP Wiki] new user: antz29

2008-11-26 Thread Lukas Kahwe Smith
On 26.11.2008, at 09:07, John Le Drew wrote: Hi Lukas I was talking to Steph over the weekend and wanted to put together a set of tutorials + examples for many of the features of PHP, starting with SPL. I thought that the Wiki would be a decent place for these, I also thought about adding

[PHP-DOC] Error Compiling

2008-11-26 Thread John Le Drew
Hi Just trying to build a fresh checkout and I'm getting -- ERROR (.../phpdoc/en/language/namespaces.xml:229:10) /para --^ Opening and ending tag mismatch: sect1 line 144 and para ERROR (.../phpdoc/en/language/namespaces.xml:256:10) /sect1 --^ Opening and ending tag

Re: [PHP-DOC] Error Compiling

2008-11-26 Thread Guillaume Plessis
Hi, I just fixed it in CVS. Thanks for this feedback. --- Guillaume Plessis Le 26 nov. 08 à 15:33, John Le Drew a écrit : Hi Just trying to build a fresh checkout and I'm getting -- ERROR (.../phpdoc/en/language/namespaces.xml:229:10) /para --^ Opening and ending tag mismatch:

Re: [PHP-DOC] Re: [PHP-WEBMASTER] [PHP Wiki] new user: antz29

2008-11-26 Thread Richard Quadling
2008/11/26 John Le Drew [EMAIL PROTECTED]: Thanks Richard Downloading the docs now :) Where is a decent place to start putting my tutorials? I really wanted to create decent use cases and examples for SPL, as so many people know of it, but have no idea how or why they would implement it.

[PHP-DOC] Documentation

2008-11-26 Thread John Le Drew
Hi All I spoke to Steph at PHPNW about helping out with the docs. There are a few areas I would love to start work on right away (initially SPL) and I just wanted to find out what the best way of contributing was? I'm familiar with DocBook etc. Cheers John

[PHP-DOC] Remove delete()

2008-11-26 Thread Jakub Vrána
Hello! Would you agree with removal of delete() dummy entry from PHP documentation? The problem is that tools using the documentation (several IDEs) think that delete() is a real function and highlight it as other functions. Jakub Vrána

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

Re: [PHP-DOC] Documentation

2008-11-26 Thread Daniel Brown
On Wed, Nov 26, 2008 at 6:46 AM, John Le Drew [EMAIL PROTECTED] wrote: Hi All I spoke to Steph at PHPNW about helping out with the docs. There are a few areas I would love to start work on right away (initially SPL) and I just wanted to find out what the best way of contributing was? I'm

Re: [PHP-DOC] Remove delete()

2008-11-26 Thread Daniel Brown
2008/11/26 Jakub Vrána [EMAIL PROTECTED]: Hello! Would you agree with removal of delete() dummy entry from PHP documentation? The problem is that tools using the documentation (several IDEs) think that delete() is a real function and highlight it as other functions. I definitely

Re: [PHP-DOC] Documentation

2008-11-26 Thread John Le Drew
Hi again I want to create an Examples section within SPL for clear use cases and examples for each of the classes / interfaces within the SPL. The idea is that it seems that a lot of the current explanation is targeted very strongly at software engineers post their CS degree. The great majority

Re: [PHP-DOC] Documentation

2008-11-26 Thread John Le Drew
Also Would I be able to look at breaking up 'Patterns' (Within classes and objects PHP5) and giving each pattern it's own page? And then perhaps adding a few more on top of Singleton and Factory... Would there be any opposition to this? Cheers John 2008/11/26 John Le Drew [EMAIL PROTECTED]:

Re: [PHP-DOC] Documentation

2008-11-26 Thread Philip Olson
I want to create an Examples section within SPL for clear use cases and examples for each of the classes / interfaces within the SPL. The idea is that it seems that a lot of the current explanation is targeted very strongly at software engineers post their CS degree. The great majority of PHP

Re: [PHP-DOC] Documentation

2008-11-26 Thread John Le Drew
Sounds good to me! I will press on with that unless we get any opposition... Cheers J 2008/11/26 Philip Olson [EMAIL PROTECTED]: I want to create an Examples section within SPL for clear use cases and examples for each of the classes / interfaces within the SPL. The idea is that it seems

Re: [PHP-DOC] Documentation

2008-11-26 Thread John Le Drew
Hi All I think that each class/interface needs to have an 'Overview' section to give a high level view of it's purpose, some use cases, and a simple example. This could be the same example that is on the examples page for the class/interface. This should list each method with a link the the

Re: [PHP-DOC] Documentation

2008-11-26 Thread Hannes Magnusson
On Wed, Nov 26, 2008 at 18:08, Philip Olson [EMAIL PROTECTED] wrote: I want to create an Examples section within SPL for clear use cases and examples for each of the classes / interfaces within the SPL. The idea is that it seems that a lot of the current explanation is targeted very strongly

[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, anything

Re: [PHP-DOC] Documentation

2008-11-26 Thread Hannes Magnusson
Please don't top-post :) On Wed, Nov 26, 2008 at 19:02, John Le Drew [EMAIL PROTECTED] wrote: Hi All I think that each class/interface needs to have an 'Overview' section to give a high level view of it's purpose, some use cases, and a simple example. This could be the same example that is

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] wrote: On the Transactions

Re: [PHP-DOC] PDO Documentation

2008-11-26 Thread Daniel Brown
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 now. And slap my hand for speaking out of turn. ;-) That's not necessary. Someone around here will gladly slap it for you. ;-P -- /Daniel P.

[PHP-DOC] IRC

2008-11-26 Thread John Le Drew
Is there an IRC channel that any of you guys hang out in? Cheers John

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 now. And slap my hand for speaking out of turn. ;-)

Re: [PHP-DOC] IRC

2008-11-26 Thread Hannes Magnusson
On Wed, Nov 26, 2008 at 19:18, John Le Drew [EMAIL PROTECTED] wrote: Is there an IRC channel that any of you guys hang out in? #php.doc @ EFNet -Hannes

Re: [PHP-DOC] PDO Documentation

2008-11-26 Thread Daniel Brown
On Wed, Nov 26, 2008 at 1:06 PM, Brandon Savage [EMAIL PROTECTED] wrote: 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

Re: [PHP-DOC] Re: [PHP-WEBMASTER] [PHP Wiki] new user: antz29

2008-11-26 Thread Hannes Magnusson
On Wed, Nov 26, 2008 at 15:43, Richard Quadling [EMAIL PROTECTED] wrote: Maybe allowing links to examples from other pages would be a good feature. We have links to functions, can we link to examples? The examples would need to be named (I think), so a naming convention may be needed. There