Re: [PHP-DOC] [PATCH] phpdoc/howto/working.xml
On Sat, 9 Aug 2003, dave wrote: Forget the last patch, this one is much more extensive! Oops. Can you please make your email cliena attach it as plain text? (You might need to rename it to .txt for your client). Derick -- Interpreting what the GPL actually means is a job best left to those that read the future by examining animal entrails. - Derick Rethans http://derickrethans.nl/ International PHP Magazine http://php-mag.net/ - -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] [PATCH] phpdoc/howto/working.xml
Forget the last patch, this one is much more extensive! Oops. Dave working.xml.patch Description: Binary data -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] [PATCH] phpdoc/howto/working.xml
Attached is a patch fixing a couple of typos and grammatical mistakes. Dave working.xml.patch Description: Binary data -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] [PATCH] phpdoc/howto/working.xml
Forget the last patch, this one is much more extensive! Oops. If you have Karma for this, please commit, the changes seem very much reasonable. Thanks, Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] [PATCH] phpdoc/howto/working.xml
On Sunday, August 10, 2003, 10:22:31 PM, Gabor wrote: Please use reply all when replying, so others will also get the mail. *nod* Can you explain the karma system more or provide a URL? I haven't found much information about it on php.net. The aforementioned URL says nothing about karma, either. It's not enough to have a CVS account. The Karma system controls what you have write access to (anybody has read access to anything on cvs.php.net even without a CVS account). This is to prevent you from messing with something you are not supposed to modify. So it can happen that you have a CVS account, but still you are unable to commit to phpdoc because you have no Karma for that. Ah, so it's just write access control to certain modules/directories? Now it all makes sense. When I think of karma, I think of good/bad karma. I suppose getting access to an extra part of the repository might be considered increasing your karma in a way. Thanks for the rundown. Goba Dave -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] [PATCH] phpdoc/howto/working.xml
Forget the last patch, this one is much more extensive! Dave -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] [PATCH] phpdoc/howto/working.xml
Please use reply all when replying, so others will also get the mail. If you have Karma for this, please commit, the changes seem very much reasonable. From http://www.php.net/cvs-php.php Submitting patches and participating in the discussion on the 'internals' list before requesting full CVS access is strongly suggested, so the PHP development team can get to know you and what you'll be contributing. I don't have a CVS account, so I was following this advice by simply submitting a patch, and the internals list seemed wrong for a phpdoc patch. Should I just apply for an account? Well that text refers to the internals list, and not phpdoc ;) I am not sure what rules should apply here... I would be happy to commit your modifications to CVS, but I am not near an environment ready for this currently. If you intend to contribute on a regular basis, I would suggest you request a CVS account. Can you explain the karma system more or provide a URL? I haven't found much information about it on php.net. The aforementioned URL says nothing about karma, either. It's not enough to have a CVS account. The Karma system controls what you have write access to (anybody has read access to anything on cvs.php.net even without a CVS account). This is to prevent you from messing with something you are not supposed to modify. So it can happen that you have a CVS account, but still you are unable to commit to phpdoc because you have no Karma for that. Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] [PATCH] phpdoc/howto/working.xml
On Saturday, August 9, 2003, 9:55:21 PM, Derick wrote: Can you please make your email cliena attach it as plain text? (You might need to rename it to .txt for your client). Sure. Sorry about that. Derick DaveIndex: working.xml === RCS file: /repository/phpdoc/howto/working.xml,v retrieving revision 1.36 diff -u -r1.36 working.xml --- working.xml 23 Jun 2003 09:47:28 - 1.36 +++ working.xml 9 Aug 2003 11:49:52 - @@ -409,7 +409,7 @@ Function names should be created, and documented, in lowercase format with an underscore separating the name components. Names without underscores are often only kept for backward - compatibilty. Document the function named with underscores + compatibility. Document the function named with underscores separating components, and mention the old one as an alias. /simpara note @@ -457,13 +457,13 @@ /listitem listitem simpara - Brevity is appreciated. Long winded descriptions of each and + Brevity is appreciated. Long-winded descriptions of each and every function are not appropriate for the reference sections. Using the errata comments as guidelines, it's easier to tell when more documentation is needed, as well as the inverse, when too much documentation in one section has increased confusion. - footnotesimparaNoone complained about too much documentation - in any section till now, so be brave to add longer explanations, + footnotesimparaNo one complained about too much documentation + in any section until now, so be brave to add longer explanations, and more than one example per function. :)/simpara/footnote /simpara /listitem @@ -655,9 +655,9 @@ para There are many active translations out there of the PHP - documentation. Some lanaguages are being maintaned by + documentation. Some languages are being maintained by a group of translators (eg. the German), some are one person - projects (eg. the Japanese). There are quite many things for + projects (eg. the Japanese). There are quite a few things for translators to know, though these are simple. /para @@ -665,7 +665,7 @@ titleStarting a New Translation/title para Starting a new language translation comes down to -the following simple steps now. +the following simple steps: itemizedlist listitem simpara @@ -678,7 +678,7 @@ listitem simpara link linkend=cvs-accountAsk for a CVS account/link. - Mention, that you would like to start a new translation. + Mention that you would like to start a new translation. /simpara /listitem listitem @@ -696,7 +696,7 @@ and literalphpdoc-LANGCODE/literal (using the literalphpdoc-LANGCODE-dir/literal alias) as described in the link linkend=chapter-cvsCVS chapter/link - of this howto. + of this HOWTO. /simpara /listitem listitem @@ -716,7 +716,7 @@ link linkend=translation-revtrackrevision tracking/link for help about how can you ease your work of tracking the English - versions, and your languages versions. + version and your language's version. /simpara /listitem /itemizedlist @@ -752,15 +752,15 @@ If you see that a manual for your language is set up, and you would like to join the group, please ask on the appropriate link linkend=chapter-maillistmailing -list/link about who is responsible to manage that +list/link about who is responsible for managing that translation. /para para If you are new to the PHP project, and you have no CVS account, you need to link linkend=cvs-accountrequest -one account/link, before you can join the work. Although +an account/link before you can join the group. Although there are some translations where just a few people have -CVS accounts, and they are responsible for comitting the +CVS accounts, and they are responsible for committing the other's works, this may not be ideal. /para /sect1 @@ -788,7 +788,7 @@ simpara Use a system to coordinate with the translators in your language. Currently we have two systems - used paralelly, the Translators files and the + used in parallel, the Translators files and the Revision comments. See the section about link linkend=translation-revtrackrevision tracking/link to learn more about this subject. @@ -833,8 +833,8 @@ made to your language's files, are correct. You may introduce illegal characters. Please always do a link linkend=chapter-validatingmake - test/link before commiting. Introducing an - error in your languages manual can stop the + test/link before committing. Introducing an + error in