Re: cvs: phpdoc /en/reference/pcntl/functions pcntl-alarm.xml pcntl-exec.xml pcntl-fork.xml pcntl-getpriority.xml pcntl-setpriority.xml
pcntl-signal.xml pcntl-wait.xml pcntl-waitpid.xml pcntl-wexitstatus.xml pcntl-wifexited.xml pcntl-wifsig
| From: | Maciek Sokolewicz | Date: | Sun, 03 Aug 2008 09:10:00 +0000 |
| Subject: | Re: cvs: phpdoc /en/reference/pcntl/functions pcntl-alarm.xml pcntl-exec.xml pcntl-fork.xml pcntl-getpriority.xml pcntl-setpriority.xml pcntl-signal.xml pcntl-wait.xml pcntl-waitpid.xml pcntl-wexitstatus.xml pcntl-wifexited.xml pcntl-wifsig |
||
| References: | 1 | Groups: | php.doc.cvs |
| Request: | Send a blank email to doc-cvs+get-1981@lists.php.net to get a copy of this message | ||
Hannes Magnusson wrote:
On Sun, Aug 3, 2008 at 00:26, Maciek Sokolewicz <tularis@php.net> wrote:I read your reply just after commiting this and I do agree with you. I can roll it back easily once a decision has been made. However, I believe that we (well, the devs mainly, but the doc team may help) should have a good look at the status of extensions. Currently there's only: * _in PECL_ (aka "unknown status, might be experimental, might be stable, we don't know") * _experimental_ (aka "it might change soon, or not. It might have a ton of bugs, or even not work at all.", which may stay in this status indefinitly because noone is developing it anymore) * _stable_ (aka "it works fine for most people, but there's no guarantee that bugs will be fixed in a reasonable timeframe") In my opinion extensions should never have a status of "in pecl", because that doesn't mean anything. Furthermore, in my opinion, extensions should be placed in one of the following categories: - experimental, actively developed but not ready yet for every-day use - experimental, unsupported - stable, actively supported - stable, passively supported (only security fixes, and bugfixes on a long timeframe) - stable, not supported (it works, but if it doesn't: tough luck) If the same kind of classification could be used in each pecl-extension, then the docs could even pick it up automatically from the code (now THAT'd be nice!)Looking at the history, it was never marked as experimental (yes, our fault). However, I strongly disagree with this change (see http://news.php.net/php.internals/39562) -Hannestularis Sat Aug 2 22:26:42 2008 UTCModified files:/phpdoc/en/reference/pcntl/functions pcntl-alarm.xml pcntl-exec.xml pcntl-fork.xml pcntl-getpriority.xml pcntl-setpriority.xml pcntl-signal.xml pcntl-wait.xml pcntl-waitpid.xml pcntl-wexitstatus.xml pcntl-wifexited.xml pcntl-wifsignaled.xml pcntl-wifstopped.xml pcntl-wstopsig.xml pcntl-wtermsig.xmlLog: (re)marking as EXPERIMENTAL, this fixes bug #45687