Merge branch 'master' of https://github.com/perl6/doc

Author: Geoffrey Broadwell

lib/Type/IO.pod

@@ -62,4 +62,30 @@ L<umask|http://en.wikipedia.org/wiki/Umask>).
 Throws an excpetion of type L<X::IO::Mkdir|/type/X::IO::Mkdir> if the
 directory cannot be created.
 
+=head2 sub run
+
+    sub run(*@args ($, *@)) returns Proc::Status:D
+
+Runs an external command without involving a shell (if possible). Expects the
+command and each of its command line arguments as a list.
+
+The return value is of L<type Proc::Status|/type/Proc::Status>.
+
+    run 'systemctl', 'restart', 'apache2'
+
+Arguments are not subject to shell expansions, shell variable interpolation or
+other shenanigans. See L<#sub shell> if you want that.
+
+=head2 sub shell
+
+    sub shell($cmd) returns Proc::Status:D
+
+Runs a command through the system shell. All shell meta characters are
+interpreted by the shell, inluding pipes, redirects, environment variable
+substitutions and so on. See L<#sub run> if you don't want that.
+
+The return value is of L<type Proc::Status|/type/Proc::Status>.
+
+    shell 'ls -lR | gzip -9 > ls-lR.gz';
+
 =end pod

lib/Type/Metamodel/MROBasedMethodDispatch.pod

@@ -21,9 +21,18 @@ VM-specific sentinel value (typically a low-level NULL value).
 
 If C<:no_fallback> is supplied, fallback methods are not considered.
 
+=head2 method find_method_qualified
+
+    method find_method(Metamodel::MROBasedMethodDispatch:D: $obj, $type, $name)
+
+Given a method name and a type, returns the method from that type. This is
+used in calls like
+
+    self.SomeParentClass::the_method();
+
 =begin comment
 
-TODO: find_method_qualified, publish_method_cache
+TODO: publish_method_cache
 
 =end comment
 

lib/Type/Proc/Status.pod

@@ -0,0 +1,44 @@
+=begin pod
+
+=TITLE class Proc::Status
+
+=SUBTITLE Information about the status of externally run programs.
+
+    class Proc::Status { ... }
+
+L<run()|/type/IO#sub run> and L<shell()|/type/IO#sub shell> return a
+C<Proc::Status> object:
+
+    my $status = run 'false';       # most UNIXes have a /bin/false
+    say $status.exit;               # 1
+    say $status.signal;             # 0  (which means: not killed by a signal)
+
+=head1 Methods
+
+=head2 method exit
+
+    method exit(Proc::Status:D:) returns Int:D
+
+Returns the numeric exit code from the program.
+
+=head2 method signal
+
+    method signal(Proc::Status:D:) returns Int:D
+
+Returns the numeric signal which caused the program to terminate, or 0 if this
+wasn't the case. You can compare that to elements of the C<Signal> enum, for
+example:
+
+    given $status {
+        when Signal::SIGSEGV { say "Use a memory-safe language next time!" }
+        when Signal::SIGPIPE { say "Pipe broken, call a plumber!"          }
+    }
+
+=head2 method pid
+
+    method pid(Proc::Status:D:)
+
+Returns the PID (process identifier) from the external program, or an
+undefined value if that isn't known.
+
+=end pod