@@ -113,7 +113,24 @@ are done doing other stuff::
113113 $process->start();
114114
115115 // ... do other things
116+
117+ $process->wait();
118+
119+ // ... do things after the process has finished
116120
121+ ..note ::
122+
123+ The:method: `Symfony\\ Component\\ Process\\ Process::wait ` method is blocking,
124+ which means that your code will halt at this line until the external
125+ process is completed.
126+
127+ :method: `Symfony\\ Component\\ Process\\ Process::wait ` takes one optional argument:
128+ a callback that is called repeatedly whilst the process is still running, passing
129+ in the output and its type::
130+
131+ $process = new Process('ls -lsa');
132+ $process->start();
133+
117134 $process->wait(function ($type, $buffer) {
118135 if (Process::ERR === $type) {
119136 echo 'ERR > '.$buffer;
@@ -122,12 +139,6 @@ are done doing other stuff::
122139 }
123140 });
124141
125- ..note ::
126-
127- The:method: `Symfony\\ Component\\ Process\\ Process::wait ` method is blocking,
128- which means that your code will halt at this line until the external
129- process is completed.
130-
131142Stopping a Process
132143------------------
133144