> Thanks for your additions. Looking forward for more.....:-) > I tried to incorporate them, also the contributions from the other people. > Have a look online http://www.holliwell.de/draft/draft1 > or download at http://www.holliwell.de/draft/draft1.tar.gz (about 4kb) > Keep in mind it`s a draft and just an attempt to gather the ideas and > contributions :-). Feel free to comment, change and so on ....
I think it is just time to heat up the discussion about this. Some additions I can think of: --- Error handling: die is not right for production, but a complex if is not needed, either one can use a user defined error function, or more easily can use trigger_error(), or user_error(), which adds much more options and possibilities than using die, and is completely appropriate to use in production: $conn = mysql_connect(...) or user_error("Cannot connect", E_USER_ERROR); This will cause the script to stop running, and to print out a PHP style error message by default. But php.ini can be set up to redirect this to syslog, or use a special error handling function. IMHO use this way of error handling in examples. Why we use it, should be explained in the "error handling" and/or "about the manual" parts. --- Sample outputs: <para> in exmaple is not allowed, so the screen example in your draft wont work with docbook. Need to invent some other type of output. --- It would be nice to hear what others think about this draft, as we can only make things standards after proper discussion, but it would be nice to have a standard in a short term. Goba