web-dev
diff --git a/‎components/css_selector.rst
Copy file name to clipboardExpand all lines: components/css_selector.rst
-1Lines changed: 0 additions & 1 deletion b/‎components/css_selector.rst
Copy file name to clipboardExpand all lines: components/css_selector.rst
-1Lines changed: 0 additions & 1 deletion
diff --git a/‎components/index.rst
Copy file name to clipboardExpand all lines: components/index.rst
+1Lines changed: 1 addition & 0 deletions b/‎components/index.rst
Copy file name to clipboardExpand all lines: components/index.rst
+1Lines changed: 1 addition & 0 deletions
diff --git a/‎components/process.rst
Copy file name to clipboard
+80Lines changed: 80 additions & 0 deletions b/‎components/process.rst
Copy file name to clipboard
+80Lines changed: 80 additions & 0 deletions
@@ -6,7 +6,6 @@ The CssSelector Component
 
     The CssSelector Component converts CSS selectors to XPath expressions.
 
-
 Installation
 ------------
 
 
@@ -8,4 +8,5 @@ The Symfony2 Components
    console
    css_selector
    finder
+   process
    yaml
@@ -0,0 +1,80 @@
+.. index::
+   single: Process
+
+The Process Component
+=====================
+
+    The Process Component executes commands in sub-processes.
+
+Installation
+------------
+
+You can install the component in many different ways:
+
+* Use the official Git repository (https://github.com/symfony/Process);
+* Install it via PEAR ( `pear.symfony.com/Process`);
+* Install it via Composer (`symfony/process` on Packagist).
+
+Usage
+-----
+
+The `:class:Symfony\\Component\\Process\\Process` class allows you to execute
+a command in a sub-process::
+
+.. code-block:: php
+
+    use Symfony\Component\Process\Process;
+
+    $process = new Process('ls -lsa');
+    $process->setTimeout(3600);
+    $process->run();
+    if (!$process->isSuccessful()) {
+        throw new RuntimeException($process->getErrorOutput());
+    }
+
+    print $process->getOutput();
+
+The ``:method::Symfony\\Component\\Process\\Process:run()`` method takes care
+of the subtle differences between the different platforms when executing the
+command.
+
+When executing a long running command (like rsync-ing files to a remote
+server), you can give feedback to the end user in real-time by passing an
+anonymous function to the
+``:method::Symfony\\Component\\Process\\Process:run()`` method::
+
+.. code-block:: php
+
+    use Symfony\Component\Process\Process;
+
+    $process = new Process('ls -lsa');
+    $process->run(function ($type, $buffer) {
+        if ('err' === $type) {
+            echo 'ERR > '.$buffer;
+        } else {
+            echo 'OUT > '.$buffer;
+        }
+    });
+
+If you want to execute some PHP code in isolation, use the ``PhpProcess``
+instead::
+
+.. code-block:: php
+
+    use Symfony\Component\Process\PhpProcess;
+
+    $process = new PhpProcess(<<<EOF
+        <?php echo 'Hello World'; ?>
+    EOF);
+    $process->run();
+
+.. versionadded:: 2.1
+    The ``ProcessBuilder`` class has been as of 2.1.
+
+To make your code work better on all platforms, you might want to use the
+``:class:Symfony\Component\Process\ProcessBuilder`` class instead::
+
+    use Symfony\Component\Process\ProcessBuilder;
+
+    $builder = new ProcessBuilder(array('ls', '-lsa'));
+    $builder->getProcess()->run();