Re: [PHP-DOC] Re: [PHP-DEV] "waldschrotts guide to nifty references" -manualpagedraft, version 0.9b From: Stanislav Malyshev (stas <email protected>)
Date: 08/20/00

RC>> Actually, you're not exaggerating, at all, about what the users have been
RC>> looking for, and are *already using* the PHP manual for.
RC>>
RC>> http://www.php.net/manual/function.imagecreate.php
RC>>
RC>> Has a sample chunk of code to build.... a clock.

No, it's annotations that have.

RC>> This is the level of detail they are looking for in the documentation.

Not sure at all. I personally don't use annotated manual (though think
it's great, just not for me).

And annotated manual is not tutorials. That's like calling Slashdot an
university :)

RC>> PHP Manual = Users Guide PHP Reference = Stripped of all code
RC>> examples, tutorials, descriptions, etc. Just raw syntax from the
RC>> main tree. This could be done programatically, as in (from
RC>> array.xml):

Good. Now if you also divide it in different files, for the sake of
modularity, my dream is perfect :) Though, maybe just a good XML editor
might help... 

-- 
Stanislav Malyshev   stas <email protected>          
+972-3-6139665 ext.106