From 75c88000bc5c53e4fca0471ab1bf929d8981dd9d Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Sun, 23 Dec 2007 03:55:12 +0000 Subject: [PATCH] MFB: Upgrade to the new-reference-structure - Split reference.xml into book.xml, setup.xml, and examples.xml - Moved from reference.xml to book.xml: - The intro text (partintro), and link to various pages - Moved from reference.xml to setup.xml: - The requirements, installation, configuration, and resources - Moved examples to the new examples.xml - Changed See Also in reference.xml from section to partintro - Changed the constants section to be an - Changed the intro ID from .intro to intro. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@248796 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/pcntl/book.xml | 76 ++++++++++++++++++++ reference/pcntl/constants.xml | 6 +- reference/pcntl/examples.xml | 85 +++++++++++++++++++++++ reference/pcntl/reference.xml | 126 +--------------------------------- reference/pcntl/setup.xml | 54 +++++++++++++++ 5 files changed, 220 insertions(+), 127 deletions(-) create mode 100644 reference/pcntl/book.xml create mode 100644 reference/pcntl/examples.xml create mode 100644 reference/pcntl/setup.xml diff --git a/reference/pcntl/book.xml b/reference/pcntl/book.xml new file mode 100644 index 0000000000..ab01430721 --- /dev/null +++ b/reference/pcntl/book.xml @@ -0,0 +1,76 @@ + + + + + + + PCNTL + + + + &reftitle.intro; + + Process Control support in PHP implements the Unix style of + process creation, program execution, signal handling and process + termination. Process Control should not be enabled within a + web server environment and unexpected results may happen if any + Process Control functions are used within a web server environment. + + + This documentation is intended to explain the general usage of + each of the Process Control functions. For detailed information + about Unix process control you are encouraged to consult your + systems documentation including fork(2), waitpid(2) and signal(2) + or a comprehensive reference such as Advanced Programming in the + UNIX Environment by W. Richard Stevens (Addison-Wesley). + + + PCNTL now uses ticks as the signal handle callback mechanism, which is + much faster than the previous mechanism. This change follows the same + semantics as using "user ticks". You use the declare + statement to specify the locations in your program where callbacks are + allowed to occur. This allows you to minimize the overhead of handling + asynchronous events. In the past, compiling PHP with pcntl enabled would + always incur this overhead, whether or not your script actually used + pcntl. + + + There is one adjustment that all pcntl scripts prior to PHP 4.3.0 must + make for them to work which is to either to use + declare on a section where you wish to allow + callbacks or to just enable it across the entire script using + the new global syntax of declare. + + + ¬e.no-windows.extension; + + + + &reference.pcntl.setup; + &reference.pcntl.constants; + &reference.pcntl.examples; + &reference.pcntl.reference; + + + + + diff --git a/reference/pcntl/constants.xml b/reference/pcntl/constants.xml index dc2ab17e1d..815f629f74 100644 --- a/reference/pcntl/constants.xml +++ b/reference/pcntl/constants.xml @@ -1,6 +1,6 @@ - -
+ + &reftitle.constants; The following list of signals are supported by the Process Control @@ -449,7 +449,7 @@ -
+
+ + &reftitle.examples; +
+ + This example forks off a daemon process with a signal handler. + + + Process Control Example + + +]]> + + +
+
+ + + diff --git a/reference/pcntl/reference.xml b/reference/pcntl/reference.xml index 0a4c55827d..c3e309bc29 100644 --- a/reference/pcntl/reference.xml +++ b/reference/pcntl/reference.xml @@ -1,138 +1,16 @@ - - - + Process Control Functions - PCNTL - -
- &reftitle.intro; - - Process Control support in PHP implements the Unix style of - process creation, program execution, signal handling and process - termination. Process Control should not be enabled within a - web server environment and unexpected results may happen if any - Process Control functions are used within a web server environment. - - - This documentation is intended to explain the general usage of - each of the Process Control functions. For detailed information - about Unix process control you are encouraged to consult your - systems documentation including fork(2), waitpid(2) and signal(2) - or a comprehensive reference such as Advanced Programming in the - UNIX Environment by W. Richard Stevens (Addison-Wesley). - - - PCNTL now uses ticks as the signal handle callback mechanism, which is - much faster than the previous mechanism. This change follows the same - semantics as using "user ticks". You use the declare - statement to specify the locations in your program where callbacks are - allowed to occur. This allows you to minimize the overhead of handling - asynchronous events. In the past, compiling PHP with pcntl enabled would - always incur this overhead, whether or not your script actually used - pcntl. - - - There is one adjustment that all pcntl scripts prior to PHP 4.3.0 must - make for them to work which is to either to use - declare on a section where you wish to allow - callbacks or to just enable it across the entire script using - the new global syntax of declare. - - - ¬e.no-windows.extension; -
- -
- &reftitle.required; - &no.requirement; -
- - &reference.pcntl.configure; - -
- &reftitle.runtime; - &no.config; -
- -
- &reftitle.resources; - &no.resource; -
- - &reference.pcntl.constants; - -
- &reftitle.examples; - - This example forks off a daemon process with a signal handler. - - - Process Control Example - - -]]> - - -
- -
+ &reftitle.seealso; A look at the section about POSIX functions may be useful. -
diff --git a/reference/pcntl/setup.xml b/reference/pcntl/setup.xml new file mode 100644 index 0000000000..5e8405a031 --- /dev/null +++ b/reference/pcntl/setup.xml @@ -0,0 +1,54 @@ + + + + + &reftitle.setup; + + +
+ &reftitle.required; + &no.requirement; +
+ + + + &reference.pcntl.configure; + + + +
+ &reftitle.runtime; + &no.config; +
+ + + +
+ &reftitle.resources; + &no.resource; +
+ + +
+ + +