Re: boo-boo in run docs?

[email protected] (Peter Pentchev) Thu, 6 Nov 2025 18:16:28 +0200

Newsgroups	perl.perl6.users
Message-ID	<[email protected]>

On Thu, Nov 06, 2025 at 02:27:43AM -0800, ToddAndMargo via perl6-users wrote:
> On 11/6/25 1:57 AM, Peter Pentchev wrote:
> > It doesn't need to be; the documentation of `run` already points to
> > the documentation of `Proc`, as you point out.
> 
> In that case, "run's" documentation should have ended at
> the Proc link.  None of the examples should have been
> included.  No need for further discussion.

That is not true, since the examples document how one can use `run`
to start a program; the fact that the returned value is a `Proc`
object does not matter. The documentation for `run` documents how
you use `run`; the documentation for `shell` documents how you
use `shell`. In both cases, they refer to the documentation for `Proc`
so that they don't have to repeat what is already written there.

G'luck,
Peter

-- 
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

signature.asc (application/pgp-signature, 833 B)