one path succeeds and another fails, the overall result will be
failure. If one succeeds, one fails, and one causes an error, then the
overall result will be an error; and so on.
+.P
+When the \fB\-\-recursive\fR flag is used, the exit code is computed
+as if all affected paths were passed, depth-first, on the command-line.