Re: boo-boo in run docs?

On 11/8/25 2:09 AM, Peter Pentchev wrote:
> 4. All the parameters to `run` are documented in `run`.


The docs for run:

sub run(
     *@args ($, *@),
     :$in = '-',
     :$out = '-',
     :$err = '-',
     Bool :$bin = False,
     Bool :$chomp = True,
     Bool :$merge = False,
     Str:D :$enc = 'UTF-8',
     Str:D :$nl = "\n",
     :$cwd = $*CWD,
     Hash() :$env = %*ENV,
     :$arg0,
     :$win-verbatim-args = False
--> Proc:D)


The actual sub:

multi sub run(
     *@args where .so,
     :$in = '-', :
     $out = '-',
     :$err = '-',
     Bool :$bin,
     Bool :$chomp = True,
     Bool :$merge,
     Str  :$enc,
     Str:D :$nl = "\n",
     :$cwd = $*CWD, :
     $env,
     :$arg0,
     :$win-verbatim-args = False) {

     my $proc := Proc.new(
        :$in, :$out, :$err, :$bin, :$chomp, :$merge, :$enc, :$nl);
     $proc.spawn(@args, :$cwd, :$env, :$arg0, :$win-verbatim-args);
     $proc
}

Looks like everything is there.



The Docs for Proc:

method new(Proc:U:
         :$in = '-',
         :$out = '-',
         :$err = '-',
         Bool :$bin = False,
         Bool :$chomp = True,
         Bool :$merge = False,
         Str:D :$enc = 'UTF-8',
         Str:D :$nl = "\n",
     --> Proc:D)


The actual source code for Proc:

my class Proc {
     has IO::Pipe $.in;
     has IO::Pipe $.out;
     has IO::Pipe $.err;
     has Str $.os-error;
     has $.exitcode is default(Nil);
     has $.signal;
     has $.pid is default(Nil);
     has @.command;

     has Proc::Async $!proc;
     has Bool $!w;
     has @!pre-spawn;
     has @!post-spawn;
     has $!active-handles = 0;
     has &!start-stdout;
     has &!start-stderr;
     has $!finished;

     submethod BUILD(
       :$in = '-',
       :$out = '-',
       :$err = '-',
       :$exitcode,
       Bool :$bin,
       Bool :$chomp = True,
       Bool :$merge,
       :$command,
       Str :$enc,
       Str:D :$nl = "\n", :
       $signal --> Nil) {
       @!command := $command.List if command.List

     method exitcode {
         self!wait-for-finish;
         $!exitcode
     }

     method signal {
         self!wait-for-finish;
         $!signal
     }



A bunch of stuff is missing from the docs:
$.extcode, $.signal, $.pid, @.command.
Mostly the things from "submethod BUILD".
I think that submethod is kind of cool!

The ones with the ! can be forgiven as they
are private to the rakumod.