On Thu, Nov 06, 2025 at 06:16:28PM +0200, Peter Pentchev wrote: > 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.
...and, perhaps even more importantly, so that the documentation for either `run` or `shell` does not need to be changed if something changes in `Proc`. 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
Description: PGP signature
