[PHP-DOC] Re: [PECL-DEV] Writing Documentation
I checked out phpdoc and created a new directory (en/reference/rpmreader) which is where I believe the documentation should go. I created all my xml files and am currently compiling it to make sure it works. My question is, do I need more rights on CVS (username: atex) to create the rpmreader directory and all the subsequent files underneath or can I just do a "cvs add rpmreader" command and then do a "cvs commit" to upload the files to cvs.php.net? Please let me know. On 10/7/05, Dan Scott <[EMAIL PROTECTED]> wrote: > Hi Andrew: > > Start with http://doc.php.net/dochowto/, then post questions to the > php-doc mailing list and we'll try to help you out the best we can. We > _really_ appreciate good documentation! > > Dan > > On 10/7/05, Andrew Teixeira <[EMAIL PROTECTED]> wrote: > > Hello, > >I wanted to post some documentation for the rpmreader module I just > > released, but I would like to do it in the usual "PHP" way (i.e. in > > the format used by the PHP manual). I seem to see that it uses > > docbook format, which is great because I have written a fair amount of > > docbook stuff. Could anyone point me to information on the > > templates/style sheets/scripts/etc. that I would need to use to make > > proper documentation for this module so it can appear either in the > > PHP documentation or at least in the same format as the PHP > > documentation? I was able to publish the module, but I feel bad not > > providing any real documentation for it. Any help would be greatly > > appreciated. > > > > -- > > PECL development discussion Mailing List (http://pecl.php.net/) > > To unsubscribe, visit: http://www.php.net/unsub.php > > > > > > -- > PECL development discussion Mailing List (http://pecl.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > >
[PHP-DOC] cvs: phpdoc /en/reference/datetime/functions date-default-timezone-set.xml
nlopess Sat Oct 8 15:35:58 2005 EDT Modified files: /phpdoc/en/reference/datetime/functions date-default-timezone-set.xml Log: link to the timezones' appendix expand the error messages (E_STRICT) http://cvs.php.net/diff.php/phpdoc/en/reference/datetime/functions/date-default-timezone-set.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc/en/reference/datetime/functions/date-default-timezone-set.xml diff -u phpdoc/en/reference/datetime/functions/date-default-timezone-set.xml:1.2 phpdoc/en/reference/datetime/functions/date-default-timezone-set.xml:1.3 --- phpdoc/en/reference/datetime/functions/date-default-timezone-set.xml:1.2 Fri Jul 29 14:16:29 2005 +++ phpdoc/en/reference/datetime/functions/date-default-timezone-set.xml Sat Oct 8 15:35:57 2005 @@ -1,5 +1,5 @@ - + date_default_timezone_set @@ -21,7 +21,9 @@ Since PHP 5.1.0 (when the date/time functions were rewritten), every call to a date/time function will generate a E_NOTICE if -the timezone isn't valid. +the timezone isn't valid, and/or a E_STRICT message +if using the system settings or the TZ environment +variable. @@ -35,7 +37,8 @@ The timezone identifier, like UTC or - Europe/Lisbon + Europe/Lisbon. The list of valid identifiers is + available in the .
[PHP-DOC] cvs: phpdoc /en/appendices timezones.xml
nlopess Sat Oct 8 15:23:50 2005 EDT Modified files: /phpdoc/en/appendices timezones.xml Log: make the html prettier http://cvs.php.net/diff.php/phpdoc/en/appendices/timezones.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/appendices/timezones.xml diff -u phpdoc/en/appendices/timezones.xml:1.1 phpdoc/en/appendices/timezones.xml:1.2 --- phpdoc/en/appendices/timezones.xml:1.1 Sat Oct 8 09:34:54 2005 +++ phpdoc/en/appendices/timezones.xml Sat Oct 8 15:23:49 2005 @@ -1,5 +1,5 @@ - + @@ -357,7 +357,7 @@ List of timezones in the group Arctic Arctic - + Arctic/Longyearbyen
[PHP-DOC] cvs: phpdoc / manual.xml.in
nlopess Sat Oct 8 15:11:47 2005 EDT Modified files: /phpdoc manual.xml.in Log: activate the timezone appendix http://cvs.php.net/diff.php/phpdoc/manual.xml.in?r1=1.211&r2=1.212&ty=u Index: phpdoc/manual.xml.in diff -u phpdoc/manual.xml.in:1.211 phpdoc/manual.xml.in:1.212 --- phpdoc/manual.xml.in:1.211 Mon Oct 3 18:15:29 2005 +++ phpdoc/manual.xml.inSat Oct 8 15:11:44 2005 @@ -2,7 +2,7 @@ + @@ -161,6 +161,7 @@ &appendices.debugger; &appendices.configure.index; &appendices.ini; + &appendices.timezones; &appendices.extensions; &appendices.aliases; &appendices.reserved;
[PHP-DOC] cvs: phpdoc /en/appendices timezones.xml
derick Sat Oct 8 09:34:55 2005 EDT Added files: /phpdoc/en/appendices timezones.xml Log: - Added a appendix showing which timezones PHP supports, somebody please add this to the main list of appendices (for some reason that didn't work when I tried it here). http://cvs.php.net/co.php/phpdoc/en/appendices/timezones.xml?r=1.1&p=1 Index: phpdoc/en/appendices/timezones.xml +++ phpdoc/en/appendices/timezones.xml List of Supported Timezones List of timezones in the group Africa Africa Africa/Abidjan Africa/Accra Africa/Addis_Ababa Africa/Algiers Africa/Asmera Africa/Bamako Africa/Bangui Africa/Banjul Africa/Bissau Africa/Blantyre Africa/Brazzaville Africa/Bujumbura Africa/Cairo Africa/Casablanca Africa/Ceuta Africa/Conakry Africa/Dakar Africa/Dar_es_Salaam Africa/Djibouti Africa/Douala Africa/El_Aaiun Africa/Freetown Africa/Gaborone Africa/Harare Africa/Johannesburg Africa/Kampala Africa/Khartoum Africa/Kigali Africa/Kinshasa Africa/Lagos Africa/Libreville Africa/Lome Africa/Luanda Africa/Lubumbashi Africa/Lusaka Africa/Malabo Africa/Maputo Africa/Maseru Africa/Mbabane Africa/Mogadishu Africa/Monrovia Africa/Nairobi Africa/Ndjamena Africa/Niamey Africa/Nouakchott Africa/Ouagadougou Africa/Porto-Novo Africa/Sao_Tome Africa/Timbuktu Africa/Tripoli Africa/Tunis Africa/Windhoek List of timezones in the group America America America/Adak America/Anchorage America/Anguilla America/Antigua America/Araguaina America/Argentina/Buenos_Aires America/Argentina/Catamarca America/Argentina/ComodRivadavia America/Argentina/Cordoba America/Argentina/Jujuy America/Argentina/La_Rioja America/Argentina/Mendoza America/Argentina/Rio_Gallegos America/Argentina/San_Juan America/Argentina/Tucuman America/Argentina/Ushuaia America/Aruba America/Asuncion America/Atka America/Bahia America/Barbados America/Belem America/Belize America/Boa_Vista America/Bogota America/Boise America/Buenos_Aires America/Cambridge_Bay America/Campo_Grande America/Cancun America/Caracas America/Catamarca America/Cayenne America/Cayman America/Chicago America/Chihuahua America/Coral_Harbour America/Cordoba America/Costa_Rica America/Cuiaba America/Curacao America/Danmarkshavn America/Dawson America/Dawson_Creek America/Denver America/Detroit America/Dominica America/Edmonton America/Eirunepe America/El_Salvador America/Ensenada America/Fort_Wayne America/Fortaleza America/Glace_Bay America/Godthab America/Goose_Bay America/Grand_Turk America/Grenada America/Guadeloupe America/Guatemala America/Guayaquil America/Guyana America/Halifax America/Havana America/Hermosillo America/Indiana/Indianapolis America/Indiana/Knox America/Indiana/Marengo America/Indiana/Vevay America/Indianapolis America/Inuvik America/Iqaluit America/Jamaica America/Jujuy America/Juneau America/Kentucky/Louisville America/Kentucky/Monticello America/Knox_IN America/La_Paz America/Lima America/Los_Angeles America/Louisville America/Maceio America/Managua America/Manaus America/Martinique America/Mazatlan America/Mendoza America/Menominee America/Merida America/Mexico_City America/Miquelon America/Monterrey America/Montevideo America/Montreal America/Montserrat America/Nassau America/New_York America/Nipigon America/Nome America/Noronha America/North_Dakota/Center America/Panama America/Pangnirtung America/Paramaribo America/Phoenix America/Port-au-Prince America/Port_of_Spain America/Porto_Acre America/Porto_Velho America/Puerto_Rico America/Rainy_River America/Rankin_Inlet America/Recife America/Regina America/Rio_Branco America/Rosario
RE: [PHP-DOC] cvs: phpdoc /en/reference/ingres-ii constants.xml
Title: RE: [PHP-DOC] cvs: phpdoc /en/reference/ingres-ii constants.xml >-Original Message- >From: Derick Rethans [mailto:[EMAIL PROTECTED]] >Sent: Sat 10/8/2005 11:48 >To: Grant Croker >Cc: phpdoc@lists.php.net > >Grant, can you *please* run make test after modifying the documentation? >We have automated build processes for documentation for the CHMs, and >the ones from last night now all failed because of the broken XML that >you introduced. My sincerest apologies – the XML has now been corrected. grant
[PHP-DOC] cvs: phpdoc /en/reference/ingres-ii constants.xml
grantc Sat Oct 8 09:11:48 2005 EDT Modified files: /phpdoc/en/reference/ingres-ii constants.xml Log: corrected invalid XML tags http://cvs.php.net/diff.php/phpdoc/en/reference/ingres-ii/constants.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/ingres-ii/constants.xml diff -u phpdoc/en/reference/ingres-ii/constants.xml:1.5 phpdoc/en/reference/ingres-ii/constants.xml:1.6 --- phpdoc/en/reference/ingres-ii/constants.xml:1.5 Fri Oct 7 12:59:33 2005 +++ phpdoc/en/reference/ingres-ii/constants.xml Sat Oct 8 09:11:46 2005 @@ -1,5 +1,5 @@ - + &reftitle.constants; &extension.constants; @@ -158,7 +158,6 @@ - INGRES_DATE_DMY @@ -170,7 +169,6 @@ - INGRES_DATE_YMD @@ -182,7 +180,6 @@ - INGRES_MONEY_LEADING @@ -195,7 +192,6 @@ - INGRES_MONEY_TRAILING @@ -209,7 +205,6 @@ -
[PHP-DOC] #34789 [NEW]: userland naming guide
From: [EMAIL PROTECTED] Operating system: irrlevant PHP version: Irrelevant PHP Bug Type: Documentation problem Bug description: userland naming guide Description: We need a guide that explains users how to name their userland functions, classes, exceptions etc without conflicting with future versions of php (or atleast keeping the risk low) .. so we will state the obvious like that we usually prefix extension stuff with the name of the extensions .. but also that we postfix iterators and exceptions with "Iterator" and "Exception" .. -- Edit bug report at http://bugs.php.net/?id=34789&edit=1 -- Try a CVS snapshot (php4): http://bugs.php.net/fix.php?id=34789&r=trysnapshot4 Try a CVS snapshot (php5.0): http://bugs.php.net/fix.php?id=34789&r=trysnapshot50 Try a CVS snapshot (php5.1): http://bugs.php.net/fix.php?id=34789&r=trysnapshot51 Fixed in CVS:http://bugs.php.net/fix.php?id=34789&r=fixedcvs Fixed in release:http://bugs.php.net/fix.php?id=34789&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=34789&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=34789&r=needscript Try newer version: http://bugs.php.net/fix.php?id=34789&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=34789&r=support Expected behavior: http://bugs.php.net/fix.php?id=34789&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=34789&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=34789&r=submittedtwice register_globals:http://bugs.php.net/fix.php?id=34789&r=globals PHP 3 support discontinued: http://bugs.php.net/fix.php?id=34789&r=php3 Daylight Savings:http://bugs.php.net/fix.php?id=34789&r=dst IIS Stability: http://bugs.php.net/fix.php?id=34789&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=34789&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=34789&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=34789&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=34789&r=mysqlcfg
Re: [PHP-DOC] cvs: phpdoc /en/reference/ingres-ii constants.xml
On Fri, 7 Oct 2005, Grant Croker wrote: > grantcFri Oct 7 12:59:35 2005 EDT > > Modified files: > /phpdoc/en/reference/ingres-iiconstants.xml > Log: > Clarified availability of new constants Grant, can you *please* run make test after modifying the documentation? We have automated build processes for documentation for the CHMs, and the ones from last night now all failed because of the broken XML that you introduced. regards, Derick
