From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM,HTML_MESSAGE,MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 3197 invoked from network); 21 Sep 2023 13:08:50 -0000 Received: from minnie.tuhs.org (50.116.15.146) by inbox.vuxu.org with ESMTPUTF8; 21 Sep 2023 13:08:50 -0000 Received: from minnie.tuhs.org (localhost [IPv6:::1]) by minnie.tuhs.org (Postfix) with ESMTP id 38504415CD; Thu, 21 Sep 2023 23:08:44 +1000 (AEST) Received: from mail-yb1-xb35.google.com (mail-yb1-xb35.google.com [IPv6:2607:f8b0:4864:20::b35]) by minnie.tuhs.org (Postfix) with ESMTPS id 6F47D415CA for ; Thu, 21 Sep 2023 23:08:31 +1000 (AEST) Received: by mail-yb1-xb35.google.com with SMTP id 3f1490d57ef6-d8181087dc9so1064404276.3 for ; Thu, 21 Sep 2023 06:08:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1695301710; x=1695906510; darn=tuhs.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=L8JhmY87nnu8hepYPArXfJc1GHF24O1lsPUeUk6Ui9U=; b=Snn0LwW7u4WVIbPWcDUulw3ADW7ek7XzCou1CAWxPIpfiGCH3AHkad79SiDo12ndjF vmPXsuz43rqu7I1vob3sMS6n1LCFgd9/ZrKOFM0usWCfJQTl0p6Xw0L49l5KJo2BUC60 LbRKGDdbKJNzZMY8EhVqt325WQwgorOzL8XIxLqht9wYxDpqkBbPb8sqpjTqdb+LP2tV 0TzZ7jdXzXvaM6aHYLoCzn69J311F0ngn/Ka+qsfZhwv+Qvq6xfaRhcNau1TPogvfCns /JnplfZP6cPS+r5WZx8DgQirFayjup3lK6BNF74PnFaeip5MZ+ZOsmp6/BUTPQXOed+V NFUg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695301710; x=1695906510; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=L8JhmY87nnu8hepYPArXfJc1GHF24O1lsPUeUk6Ui9U=; b=XA/ykY+NImo9fV1LU13ACbentE6skt36MvPqjiIvg3xcstxQGeul1Crd1vxB08oAey fa8GnatnI2rqRlI5AuKEL8tjqcwfxdzXKR/UI9TuldYfSwFI4AlM7xVlH0+S2m1Yd0Hy 1/OLli1r1fQIWX0ZySW0NJLS13zL9J2VveREz2zrMY5oSRz3bzI9eGHfbMeTPxWDnEog 7DthSwb6HouY6meUUf8c4CmiLd0K9XdCbagiiNKbiXQzHOoeIlnsG535FH56iLCs6PjP VuKmtbeHWU8Lj+noMetG2Rg1+PJojAKGw965X1B4wXB13+nuDPzpfI7wGhNSYJiyaQcH g8iA== X-Gm-Message-State: AOJu0YznYrexXzUMhB2IhTYOiUwI+gArlIcS+WN9+3GZlDKCCV6bVV/0 nUoDm8SevFzpNdvSSSEWnAG7XdTQwKoXzq8bU9c= X-Google-Smtp-Source: AGHT+IG12L+AoWcfF+JNYQkLpanP52vBNd7YA0+OqaW8k5UEhUGSqGMlX7+fOVoDb9XWzSItmDAw/GuX4JUK/yGeMeY= X-Received: by 2002:a25:e905:0:b0:d81:7ced:456d with SMTP id n5-20020a25e905000000b00d817ced456dmr5743264ybd.13.1695301710394; Thu, 21 Sep 2023 06:08:30 -0700 (PDT) MIME-Version: 1.0 References: <4CmySC-mFud1dlrqfAq1itmNKoTWVi8cTuAqCvtUengKvv5CWEoYCFf6-I18dwf5BVSZWAxC-B6BP6Y1e0Gi_mlga344b5cxu5TlUCLXHeg=@protonmail.com> <20230919233925.GB28844@mcvoy.com> <20230920195635.GG28844@mcvoy.com> In-Reply-To: From: "John P. Linderman" Date: Thu, 21 Sep 2023 09:08:19 -0400 Message-ID: To: Wesley Parish Content-Type: multipart/alternative; boundary="0000000000003c3aa00605de3040" Message-ID-Hash: LAH25FB56EYUBTFGAGLVD3LI3ONEW2IZ X-Message-ID-Hash: LAH25FB56EYUBTFGAGLVD3LI3ONEW2IZ X-MailFrom: jpl.jpl@gmail.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: tuhs@tuhs.org X-Mailman-Version: 3.3.6b1 Precedence: list Subject: [TUHS] Re: Project Idea: The UNIX Programmer's Manual: Heritage Edition List-Id: The Unix Heritage Society mailing list Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: --0000000000003c3aa00605de3040 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable One of the things I liked about Mark Rochkind's original "Advanced UNIX Programming" book was that he not only provided examples of what to do, but also examples of what NOT to do, like failing to close the write end of a pipe in a child that expects to read input. I'm not sure manual pages are the right place for this sort of thing, but it certainly is valuable. On Thu, Sep 21, 2023 at 12:10=E2=80=AFAM Wesley Parish wrote: > On 21/09/23 10:31, Dave Horsfall wrote: > > On Wed, 20 Sep 2023, Larry McVoy wrote: > > > > [...] > > > >> I like examples in man pages, I think it jump starts you into using th= e > >> program more easily but maybe that's just me. > > No, it's not just you :-) > > > > -- Dave > > Seconded. IDK when I was learning Linux, how many times I would've been > unable to follow the reference in the Linux man pages without a > reference example or more to show me how I could do it myself. > > Wesley Parish > > --0000000000003c3aa00605de3040 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
One= of the things I liked about Mark Rochkind's=C2=A0original=C2=A0"A= dvanced UNIX Programming" book was that he not only provided examples = of what to do, but also examples of what NOT to do, like failing to close t= he write end of a pipe in a child that expects to read input. I'm not s= ure manual pages are the right place for this sort=C2=A0of thing, but it ce= rtainly is valuable.

On Thu, Sep 21, 2023 at 12:10=E2=80=AFAM Wesley P= arish <wobblygong@gmail.com&= gt; wrote:
On 21= /09/23 10:31, Dave Horsfall wrote:
> On Wed, 20 Sep 2023, Larry McVoy wrote:
>
> [...]
>
>> I like examples in man pages, I think it jump starts you into usin= g the
>> program more easily but maybe that's just me.
> No, it's not just you :-)
>
> -- Dave

Seconded. IDK when I was learning Linux, how many times I would've been=
unable to follow the reference in the Linux man pages without a
reference example or more to show me how I could do it myself.

Wesley Parish

--0000000000003c3aa00605de3040--