Updating example 10-2 from package.xml-manual? (was: Mail_IMAP examples)

Hi, refering to this email from pear-dev by Richard, I also thought if it might be a good idea to change the example 10-2 at http://pear.php.net/manual/en/developers.packagedef.php Would you agree with me that it might be a good idea to introduce the "docs" dir below examples, because this is already declared as the current standard for package layout as detailed in http://pear.php.net/group/docs/20031114-pds.php Regards, Stefan ------- Forwarded message follows ------- From: "Richard York" <richy@smilingsouls.net> To: "bmansion at mamasam dot com" <pear-dev@lists.php.net> Copies to: <pear-dev@lists.php.net> Date sent: Sat, 28 Feb 2004 17:40:58 -0500 Subject: [PEAR-DEV] RE: [PEAR-BUG] #923 [NEW]: Mail_IMAP examples should not be installed in the Mail dir ! [ Double-click this line for list subscription options ] >The examples directory is installed in the Mail directory but must be >installed in the docs/ directory. Please try to understand how all >this works by looking at another existing package.xml file, >QuickForm's package.xml for example. BTW, there is no need to make a >new release each time, just replace the last release. I can't >remember where this can be done on pear website and have not been >able to find it but I know it can be done. Ask the pear-dev list, >they will let you know. Ok my question is this... if the examples aren't installed in the Mail directory, then how is the user supposed to know where to find the examples? This may be obvious to PEAR developers, but I don't think its obvious to the average user. Especially someone who is new to PEAR. Second, the F.A.Q. at http://pear.php.net/manual/en/developers.packagedef.php shows examples being placed in the same directory as the class file. Look at example 10-2. It doesn't say anything about putting them in a docs directory. Third, if I don't update the version number, how is the user supposed to know that I've fixed or changed anything? (Even if it is something small). Regards, Richard York -- PEAR Development Mailing List (http://pear.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php ------- End of forwarded message -------