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_INVALID,DKIM_SIGNED, HTML_MESSAGE,MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 14505 invoked from network); 13 Jan 2022 16:55:27 -0000 Received: from minnie.tuhs.org (45.79.103.53) by inbox.vuxu.org with ESMTPUTF8; 13 Jan 2022 16:55:27 -0000 Received: by minnie.tuhs.org (Postfix, from userid 112) id 837539CFF7; Fri, 14 Jan 2022 02:55:26 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 5677D9CF7E; Fri, 14 Jan 2022 02:55:21 +1000 (AEST) Authentication-Results: minnie.tuhs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=ccc.com header.i=@ccc.com header.b="HQkBeF8z"; dkim-atps=neutral Received: by minnie.tuhs.org (Postfix, from userid 112) id 755B39CF7E; Fri, 14 Jan 2022 02:55:19 +1000 (AEST) Received: from mail-qk1-f174.google.com (mail-qk1-f174.google.com [209.85.222.174]) by minnie.tuhs.org (Postfix) with ESMTPS id F059A9C78F for ; Fri, 14 Jan 2022 02:55:18 +1000 (AEST) Received: by mail-qk1-f174.google.com with SMTP id c190so6118097qkg.9 for ; Thu, 13 Jan 2022 08:55:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ccc.com; s=google; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=+zjg79wB4p1FrJct97eQtHNVcDy+bwEwRl68QEX9WdI=; b=HQkBeF8z8ccx77Vwyk/b0rB8Idn5mPnmm4pHCvrizUiaYvKwMh8qjhmBYdPWNZ9wr2 0qBB99zz4CnANTc5jK99oOawMBrmifuAkv54iTgpLlOHl022bQnx+tcCC23TOaoha4Dw 17gQausc8JM8rM9iQO2ryKP3astMPkELkUkEM= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=+zjg79wB4p1FrJct97eQtHNVcDy+bwEwRl68QEX9WdI=; b=TChtaaiipJUoS4jtJU0DkM2UW5/zPvrX57kETR2H96Y0DDaE47e07BZNSZEoAT6GFN fs/vrHjqegjznsLP5Qx5k2bXWHwFFzcNabaRvkaPxuo6aV/hinOYEN98sFCuZPNZ9uZL S3MkJ1BSfIxDTtEC4DFRm3GnXNUhd2kHqQJ36hoJwLYYfsO7tk8r7TRlJReAxOJm9UBF 3/3rWVCzQGAs3Bat11/BBw/JkQyPlT1iTAk+BbPGUs0j1/MtEjfzds+o0mPiWcLufgf7 Bne7N/PTNX4zaC41GeVoCVPN6fR1pmGId8KHXCAZb+hCvcGgX+Wo6pGqoT28GcR5scGN vFgA== X-Gm-Message-State: AOAM533Kx1MraLamvGl0B23NXHw7m8q8G3bsIKLusgBLp8Nr1cHY6khL 22GZmkWQzyLEmwyhxWsnF4gmoN7+nT3RrgcHkMh+CA== X-Google-Smtp-Source: ABdhPJyii81IA/Nmg+Z6lWez0KnhK9adIlUdxX1weSUWk6Qui4ifV50VtonF7OsPnxIoBU7vyTESS8db0WjEN37bGuc= X-Received: by 2002:a05:620a:450e:: with SMTP id t14mr3749844qkp.748.1642092917852; Thu, 13 Jan 2022 08:55:17 -0800 (PST) MIME-Version: 1.0 References: <7w4k67a8oi.fsf@junk.nocrew.org> <20220113165207.GD7175@mcvoy.com> In-Reply-To: <20220113165207.GD7175@mcvoy.com> From: Clem Cole Date: Thu, 13 Jan 2022 11:54:51 -0500 Message-ID: To: Larry McVoy Subject: Re: [COFF] Scribe (Typesetting System) and Unix X-BeenThere: coff@minnie.tuhs.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: Computer Old Farts Forum List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Computer Old Farts Followers Content-Type: multipart/mixed; boundary="===============4829468163892447059==" Errors-To: coff-bounces@minnie.tuhs.org Sender: "COFF" --===============4829468163892447059== Content-Type: multipart/alternative; boundary="0000000000000e9ee405d5798ddd" --0000000000000e9ee405d5798ddd Content-Type: text/plain; charset="UTF-8" On Thu, Jan 13, 2022 at 11:52 AM Larry McVoy wrote: > On Thu, Jan 13, 2022 at 04:42:53PM +0000, Lars Brinkhoff wrote: > > Clem Cole wrote: > > > I always got the impression that texinfo was more of a shot against > > > man pages and trying to push the purity of the 'ITS-way' to Unix. > > > > ITS had a hypertext documentation system, so my assumtion would be that > > RMS wanted to bring along that to the GNU vision. I don't see that's it > > would be abount purity, whatever that would mean for documentation. > > So you know how when you go into someone else's program to fix a bug and > they have a hideous coding style? Have you ever had someone else fix a > bug in your code and they reformat everything so git blame looks like > they wrote the whole thing? That's rude, right? If you were fixing > the bug in some crappy coding style, you fix it in that crappy coding > style, it's not your style but it is the polite thing to do. > > If we agree on that then we can move on to RMS and texinfo. Providing > texinfo docs for Unix commands is like reformatting the code. It's > rude. The Unix way is man pages for basic usage and a user guide, > usually in -ms. Not doing it that way is trying to change the way > the system works and it's just rude. > > If I were working on ITS and techinfo is how they do their docs, that's > how I'd do docs there, it would be rude to force man pages on system > that doesn't work that way. > Amen bro ... Amen --0000000000000e9ee405d5798ddd Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable


On Thu, Jan 13, 2022 at 11:5= 2 AM Larry McVoy <lm@mcvoy.com> w= rote:
On Thu, Jan 13, 2022 at 04:42:53PM +0000, L= ars Brinkhoff wrote:
> Clem Cole wrote:
> > I always got the impression that texinfo was more of a shot again= st
> > man pages and trying to push the purity of the 'ITS-way' = to Unix.
>
> ITS had a hypertext documentation system, so my assumtion would be tha= t
> RMS wanted to bring along that to the GNU vision.=C2=A0 I don't se= e that's it
> would be abount purity, whatever that would mean for documentation.
So you know how when you go into someone else's program to fix a bug an= d
they have a hideous coding style?=C2=A0 Have you ever had someone else fix = a
bug in your code and they reformat everything so git blame looks like
they wrote the whole thing?=C2=A0 That's rude, right?=C2=A0 If you were= fixing
the bug in some crappy coding style, you fix it in that crappy coding
style, it's not your style but it is the polite thing to do.

If we agree on that then we can move on to RMS and texinfo.=C2=A0 Providing=
texinfo docs for Unix commands is like reformatting the code.=C2=A0 It'= s
rude.=C2=A0 The Unix way is man pages for basic usage and a user guide, usually in -ms.=C2=A0 Not doing it that way is trying to change the way
the system works and it's just rude.

If I were working on ITS and techinfo is how they do their docs, that's=
how I'd do docs there, it would be rude to force man pages on system that doesn't work that way.
= Amen bro ... Amen=C2=A0
--0000000000000e9ee405d5798ddd-- --===============4829468163892447059== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Content-Disposition: inline X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KQ09GRiBtYWls aW5nIGxpc3QKQ09GRkBtaW5uaWUudHVocy5vcmcKaHR0cHM6Ly9taW5uaWUudHVocy5vcmcvY2dp LWJpbi9tYWlsbWFuL2xpc3RpbmZvL2NvZmYK --===============4829468163892447059==--