Re: Suggested text for the Tidy example

On Dec 5, 2007 3:47 PM, Keryx Web <webmaster@keryx.se> wrote: > Page in question: > > http://docs.php.net/manual/en/tidy.examples.php > > Suggestions (summary): > > 1. Change the example to use a strict doctype, and include the output > from the script. > > 2. Explain what has happened > > 3. Give another example where a different type snippet is corrected > > 4. Explain what has happened > > 5. Give a third example where valid, but un-semantic, code will not be > made semantic, to show how one still needs to consider proper usage, > even though tidy is being used. (The chapter on Tidy in PHP Cookbook by > O'Reilly gives a really faulty explanations in this regard.) [snip] Is that text copy&paste from that book? If so, we can't use it. If not, cool! Any chance you could "DocBookify" all this yourself? (If not, no biggy, I can do it). #1) cvs -d:pserver:cvsread@cvs.php.net/repository co phpdoc && cd phpdoc #2) vim en/reference/tidy/examples.xml #3*) php configure.php ### Quickly view the results [optional] #3b) pear install http://doc.php.net/phd/PhD-0.2.1.tgz #3c) phd -d .manual.xml -p tidy.examples #3d) firefox html/tidy.examples.html #4) cvs diff en/reference/tidy/examples.xml > tidy.examples.patch #5) mail the patch The howto (http://php.net/dochowto) is a good read if you are interested in regularly contributing and get your own cvs account to commit these things yourself. Make sure you at least read, and follow, our conventions; http://doc.php.net/php/dochowto/c572.php *) Repeat step#2-3 until you get "All Good!" -Hannes