Re: boo-boo in run docs?

[email protected] (Peter Pentchev) Sat, 8 Nov 2025 20:49:16 +0200
Newsgroups perl.perl6.users
Message-ID <[email protected]>
--TI4s12aocKgGC9dC
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Sat, Nov 08, 2025 at 04:15:22AM -0800, ToddAndMargo via perl6-users wrot=
e:
> On 11/8/25 2:09 AM, Peter Pentchev wrote:
> > 4. All the parameters to `run` are documented in `run`.
>
> The Docs for Proc:

I assume you are quoting https://docs.raku.org/type/Proc

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

The structure of the page that leads to the part you quoted is:

# class Proc

## Methods

### routine new

<what you quoted>

This is not "the Docs for Proc". Immediately above that part,
it says "routine new", and this is all in a section called "Methods".

What does that mean?

It means that this is the documentation for `Proc.new`, the constructor.
The constructor is only one of the methods.

The rest of the page documents the rest of the methods, or at least
those that are supposed to be accessed by other code, like e.g. exitcode.

Repeat after me:

The constructor is only one of the methods.
The rest of the methods are described on the rest of the page.

The constructor is only one of the methods.
The rest of the methods are described on the rest of the page.

The constructor is only one of the methods.
The rest of the methods are described on the rest of the page.

G'luck,
Peter

--=20
Peter Pentchev  [email protected] [email protected] [email protected]
PGP key:        https://www.ringlet.net/roam/roam.key.asc
Key fingerprint 2EE7 A7A5 17FC 124C F115  C354 651E EFB0 2527 DF13

--TI4s12aocKgGC9dC
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEELuenpRf8EkzxFcNUZR7vsCUn3xMFAmkPkKgACgkQZR7vsCUn
3xNmtxAAz/zb2kXugd2kv70JkFD+6qMRjk4+oI5xSN1TxZgJaTBSTu+BxTFldnfu
ThyLJFsii+KfsL9wVrux88IVfsBAblF5+VvSQ6z9+b8tX3KlAsCXVkrz4MZ7S9sT
4f0a0VAT5AwgbqZWiAesMJXaahn9OdeiuMPuLJYKSoqxfjHSjr+b9Zexh3Nx0/FZ
G55vorr7kT240mwbV0sUfWk/dGro10k+f/8cbRTxd0BDvJA5uVRUZjyE69/knM5c
0P+CJAeinjLHEwFXcLl0lSn2YRlsqIms09sVdlO15RzaF7UlNrgZrTT/flxI/2gL
Dcn67gFzCk4OGWhpWOgmDtXvMwtvc9YETln2e+EyCBrRb9FxNgQCDOZzP42MyS1I
zAao2+OLP6VR2URs+6LJV4kPEgsuKGbnC94L2PttYFSq71VsqxkjmSTZEN/k6rCC
P6nzrMUmdRS2tXUpweiJI5K5FwqGdsGmqwzQe2Ki3l4c2b8AKlEsvwAZOs/K6zzh
1injE7GJVXbk9ogZId10V7+apWUUxGCn8UT0MUBoliVgwLFJG/SN+buf2xJ5qvsz
v3ZoV4R43PtVEY1YmYAu+D2THRtzDDAohEIVK1O0gwrW+FFqZ7yT42thAQn3cHJ/
3NDRLpZ8OdeUjkmgULzQ0+P4qz9H0hGZonfNbUfcNSROGwECU/k=
=DJYP
-----END PGP SIGNATURE-----

--TI4s12aocKgGC9dC--