Re: [Fwd: SPL Exception documentation]
| From: | Hannes Magnusson | Date: | Mon, 20 Oct 2008 12:41:39 +0000 |
| Subject: | Re: [Fwd: SPL Exception documentation] | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969379503@lists.php.net to get a copy of this message | ||
Hi Schohn!
Awesome work!
Writing examples for each would be a great idea. I'm a bit unsure what
exactly would be the best approach.. Most of the examples would be
pretty much identical except for "throw new ExceptionName;" line :]
Maybe create an new chapter called "Exception examples"?
That chapter could include examples for few of the exceptions (i.e.
how to throw and catch them) and maybe a example or two on how to
extend the exceptions...
See en/reference/sdo/examples.xml for a fairly good example markup.
I can write up an "quicky article" on how to document such stuff if you want...?
May I suggest you submit a CVS account request (http://php.net/cvs-php)? :)
-Hannes
p.s. I assume your mail got blocked by the mailinglist because the
attachment was to big.
Try uploading the .zip file to www somewhere and simply link to it next time :)
On Sat, Oct 18, 2008 at 16:26, Schohn Cedric <morgue1@free.fr> wrote:
> Hi Hannes,
>
> I have tried to send the following e-mail to the list without success so I
> forward it to you.
>
> I have complete the first step : documenting exception but I have some
> problems to write examples.
> I send you the documentation with the book.xml file
>
> Regards
>
> Schohn Cédric
>
> -------- Message original --------
> Sujet : SPL Exception documentation
> Date : Sat, 18 Oct 2008 00:41:09 +0200
> De : Schohn Cedric <morgue1@free.fr>
> Pour : phpdoc@lists.php.net
>
> Hi everybody,
>
> I have documented the SPL exceptions (attached in the e-mail).
> I don't understand the aim of the DomainException exception so the
> documentation is "short".
>
> I also what to add some example for some exception but I don't found how
> do it easily.
>
> I hope for helping you in documenting PHP or translate documentation
> into French.
>
> If you have any feedback, feel free to send me it.
>
> Regards
>
> Schohn Cedric
>
>
>
>
>