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,MAILING_LIST_MULTI, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 4796 invoked from network); 29 Jun 2023 14:02:54 -0000 Received: from minnie.tuhs.org (50.116.15.146) by inbox.vuxu.org with ESMTPUTF8; 29 Jun 2023 14:02:54 -0000 Received: from minnie.tuhs.org (localhost [IPv6:::1]) by minnie.tuhs.org (Postfix) with ESMTP id 56B6E431CD; Fri, 30 Jun 2023 00:02:50 +1000 (AEST) Received: from mail-oo1-xc2f.google.com (mail-oo1-xc2f.google.com [IPv6:2607:f8b0:4864:20::c2f]) by minnie.tuhs.org (Postfix) with ESMTPS id 38F3C4319C for ; Fri, 30 Jun 2023 00:02:42 +1000 (AEST) Received: by mail-oo1-xc2f.google.com with SMTP id 006d021491bc7-55e1a9ff9d4so430025eaf.1 for ; Thu, 29 Jun 2023 07:02:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1688047346; x=1690639346; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=tTZ1aX+p37chH4O7wmsutfQ6hc2FQFCtr+slK7V4AWc=; b=Eu34EiyKg4MZX7+ZKpYm4zYPuzQKuZVPNQObCdS9KF+p3DzvrlUqaOefrp32zGYlPA j7z8kNIXM0J7bYbSBXX4sNqXE0/BKYbRCA65DdFURQVm8RrM/wLckrXha9ZFU3g97m+B 8pPmjmkIia567Jn4s+m+fLkz7+6t+1baWUGBB/amDHmGPUnUlt1rNz3XVkXVMadolrIG hOsJwr+Bn/daRjTU47Tair1M0ijvsziu63iiMtfGjsgCziOEOseqCAqaPII3echyudxU CTcgtC/JkqLkOErxczUfjDyy80MXrLN/xHUgeMlPXPTFwMQWxFqK7q2a6abiNAu+Iw+u RchQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1688047346; x=1690639346; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=tTZ1aX+p37chH4O7wmsutfQ6hc2FQFCtr+slK7V4AWc=; b=Eh8yuEQu0dXIpGDmIxeB2+vP02f0KWXmfzd+09xHgr/NctIvYfRL5ZbAKLv4ngYBOd UYuzS0Hi72LQYNIHG/xoHNQnohiIyAKsckLV7PEH78V6oRvmtjzBk3uCuCsbbR6Y5hUQ 4qP1R7NFuJLwQZKzNCoug4Y8Yn7/U0sVruSH/5bg00vdRTk5N6TdrP9WY30ecP4/0MYA pk7u5z3XUkgshR9fNhrN7PODzTnnewLMsgsm3xR/kpNeVkd9hy9f8yFIEFb43Hs2DXwZ ouoG5CSlo35IX7Z76hwz55XzYycZi+5XAb6nQWEkLzn5+mfOBtclficidm9LiNZO6sEx Ih4w== X-Gm-Message-State: AC+VfDzy4lB6eDp7LVS/bJYeYbNv3+3vV7O7OCH6Hcah4I76Hewufl50 ud2tJtPKR6sNKy5jC0KD//I= X-Google-Smtp-Source: ACHHUZ6YuWIZSsO68ppz2ZZHB9WclQHIOiDrptvjYY+2oqOOqoA2BaWG99ExhS4gsEf9//yKfRaWNw== X-Received: by 2002:a05:6820:447:b0:560:c558:b6f9 with SMTP id p7-20020a056820044700b00560c558b6f9mr2755245oou.2.1688047345814; Thu, 29 Jun 2023 07:02:25 -0700 (PDT) Received: from illithid (ip68-12-97-90.ok.ok.cox.net. [68.12.97.90]) by smtp.gmail.com with ESMTPSA id z4-20020a4ac204000000b0056345fd33e4sm3883852oop.34.2023.06.29.07.02.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 29 Jun 2023 07:02:25 -0700 (PDT) Date: Thu, 29 Jun 2023 09:02:23 -0500 From: "G. Branden Robinson" To: segaloco Message-ID: <20230629140223.gg4mgvsd7aigbj4e@illithid> References: <20230628234750.GE43966@eureka.lemis.com> <237fe42c-7803-33cc-68c3-c9a05966b95a@riddermarkfarm.ca> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="czgdnwazxf6bdcz6" Content-Disposition: inline In-Reply-To: Message-ID-Hash: YYRJIYUWUT257QH2SRZWDVLSOM3ZYKFN X-Message-ID-Hash: YYRJIYUWUT257QH2SRZWDVLSOM3ZYKFN X-MailFrom: g.branden.robinson@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: The Eunuchs Hysterical Society X-Mailman-Version: 3.3.6b1 Precedence: list Subject: [TUHS] Re: Trying to date "A Supplemental Document For Awk" List-Id: The Unix Heritage Society mailing list Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: --czgdnwazxf6bdcz6 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline At 2023-06-29T06:27:44+0000, segaloco via TUHS wrote: > Man of course finds use in the manual pages (although there are > different representations of manpages in nroff over time.) Setting aside the well known bifurcation between man(7) and mdoc(7), which manage to stay out of each other's way in the macro name space, I'm not aware of any comparative survey of different man(7) implementations. Ultrix at some point--I have no insight into the chronology of it--had a large set of extensions that remains quietly documented and supported by groff to this day, albeit off in a corner where it seems to receive little attention. (Just as well, in my opinion, as not all of its innovations are worthy of embrace.) As far as other vendor extensions and developments go, I have collected all of the information known to me into the groff_man(7) page in the any-minute-now groff 1.23.0 release. Here are the relevant sections. (There are two because concept and implementation are distinguishable.) History M. Douglas McIlroy designed, implemented, and documented the AT&T man macros for Unix Version 7 (1979) and employed them to edit the first volume of its Programmer's Manual, a compilation of all man pages supplied by the system. That man supported the macros listed in this page not described as extensions, except .P and the deprecated .AT and .UC. The only strings defined were R and S; no registers were documented. .UC appeared in 3BSD (1980). Unix System III (1980) introduced .P and exposed the registers IN and LL, which had been internal to Seventh Edition Unix man. PWB/UNIX 2.0 (1980) added the Tm string. 4BSD (1980) added lq and rq strings. SunOS 2.0 (1985) recognized C, D, P, and X registers. 4.3BSD (1986) added .AT and .P. Ninth Edition Research Unix (1986) introduced .EX and .EE. SunOS 4.0 (1988) added .SB. The foregoing features were what James Clark implemented in early versions of groff. Later, groff 1.20 (2009) originated .SY/.YS, .TQ, .MT/.ME, and .UR/.UE. Plan 9 from User Space's troff introduced .MR in 2020. Authors The initial GNU implementation of the man macro package was written by James Clark. Later, Werner Lemberg supplied the S, LT, and cR registers, the last a 4.3BSD-Reno mdoc(7) feature. Larry Kollar added the FT, HY, and SN registers; the HF string; and the PT and BT macros. G. Branden Robinson implemented the AD and MF strings; CS, CT, and U registers; and the MR macro. Except for .SB, the extension macros were written by Lemberg, Eric S. Raymond, and Robinson. This document was originally written for the Debian GNU/Linux system by Susan G. Kleinmann. It was corrected and updated by Lemberg and Robinson. The extension macros were documented by Raymond and Robinson. I welcome any further insights people can offer. This man page isn't the best place to document extensions that withered on the vine (like Eighth/Ninth Edition Research Unix's addition of multi-column macros for man(7)), but I wouldn't mind collecting such things into some sort of auxiliary article. While the mandoc(1)/mdocml project's "History of UNIX Manpages"[1] is an invaluable resource, it doesn't really do what's written on the tin, and serves more as a history of (some) *roff _formatters_--not of the man(7) language. I assume that this stance is in part due to the unease bordering on antipathy that mandoc(1) proponents have for the man(7) macro package. In their view, everybody should be writing mdoc(7). Unfortunately this lacuna has left useful historical information about the man(7) package uncollected. Regards, Branden [1] https://manpages.bsd.lv/history.html --czgdnwazxf6bdcz6 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAmSdjuYACgkQ0Z6cfXEm bc4ruxAAmiOx+4XnrwTHlhsNrJdCQnrdKSpuymkJDOYZIgD735HuqAbmnCIKdOEE hnsX9cJUiSI87RcLKNY25ntPdsu9peM3fiwqTrQtMn1ZoZOWpvCbyxysCWARUGvj vNDybn4t0+pz/ZCY7qxRmcjPRwMTgqBLPeJ1ovc7MnjEOtdm/1gOhNR7oESdcIN+ hYbuiD5g+BjlKhX4zgPQvSLeG7MVEaHITxbSlF46aqww0QOf3FDqNmKD7gqjFjkz Y8obkdQFLj0kxvQdlU8c+2uOL9+HCBp1rsb2PFOuYYkUBlOlFhMT/vf3GuKtRFND YjiZAH2T4bnXD8Fbnw+H5OG9Fr0KwstlaE/RXrDHKXuHUqluY07S4ShnlVrePxND OtNnLq3GFJx4HUzOdccp6J5AAiD0K7pGwHn8YamsKW8GQ5HcTqzHTr4X/N+AoHJ3 EJHjxtJ5zXRK7OFktJf2BLEWpFoAoW8Z2WmeiaUnurEUy8tGggd6Fg9kv7iXXwqP r/ZUFxA4Au84X8h0zGJnZIqmlWI3anbOWm+luEyQEjBc7PUChNjwYqi7J5pP5WHj mXdwBDQApIY0imOUSuyYrnJwanSSSfxHcqyMAbJXp9/W3FHJx0K7VbJOY8HRIRgD CJxhIMK1janD7zsiPr35nA0jPEuurtPp5zQyPq6hUiHlaklbiLI= =Eomp -----END PGP SIGNATURE----- --czgdnwazxf6bdcz6--