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=-1.0 required=5.0 tests=MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 8833 invoked from network); 10 Jan 2022 20:46:31 -0000 Received: from minnie.tuhs.org (45.79.103.53) by inbox.vuxu.org with ESMTPUTF8; 10 Jan 2022 20:46:31 -0000 Received: by minnie.tuhs.org (Postfix, from userid 112) id 697F09C20C; Tue, 11 Jan 2022 06:46:29 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 106C79C0CA; Tue, 11 Jan 2022 06:46:18 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id 40A8B9C0CA; Tue, 11 Jan 2022 06:46:16 +1000 (AEST) Received: from sdaoden.eu (sdaoden.eu [217.144.132.164]) by minnie.tuhs.org (Postfix) with ESMTPS id C8CCB9C0BE for ; Tue, 11 Jan 2022 06:46:14 +1000 (AEST) Received: from kent.sdaoden.eu (kent.sdaoden.eu [10.5.0.2]) by sdaoden.eu (Postfix) with ESMTPS id CA66C1605C; Mon, 10 Jan 2022 21:46:12 +0100 (CET) Received: by kent.sdaoden.eu (Postfix, from userid 1000) id 432EB2CC8; Mon, 10 Jan 2022 21:46:12 +0100 (CET) Date: Mon, 10 Jan 2022 21:46:12 +0100 Author: Steffen Nurpmeso From: Steffen Nurpmeso To: Blake McBride Message-ID: <20220110204612.21c1y%steffen@sdaoden.eu> In-Reply-To: References: <20211231234039.GU31637@mcvoy.com> <20220101005605.GL75481@eureka.lemis.com> <20220101031511.GB8135@mcvoy.com> Mail-Followup-To: Blake McBride , Larry McVoy , TUHS main list , Douglas McIlroy User-Agent: s-nail v14.9.23-207-g7f6b3a0acb OpenPGP: id=EE19E1C1F2F7054F8D3954D8308964B51883A0DD; url=https://ftp.sdaoden.eu/steffen.asc; preference=signencrypt BlahBlahBlah: Any stupid boy can crush a beetle. But all the professors in the world can make no bugs. Subject: Re: [TUHS] TeX and groff (was: roff(7)) X-BeenThere: tuhs@minnie.tuhs.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: The Unix Heritage Society mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: TUHS main list , Douglas McIlroy Errors-To: tuhs-bounces@minnie.tuhs.org Sender: "TUHS" Blake McBride wrote in : |I've used nroff/troff/TeX with many of their various macro packages over |about a 35 years span. During that time, I've done many single-page |documents as well as documents as long as 350 pages. I also modified a |version of nroff to create business forms for Laster printers. This is |still being used commercially. This is one person's opinion: | |1. Perhaps owing to my limited intelligence, and in spite of the fact that |I've used TeX successfully on many documents, I have never been able to |fully understand TeX. Apparently, it is too much for me. Troff, on the |other hand, has made full sense to me. I was able to make it do what I |wanted almost always. I enjoy using troff more because I find it simpler, |and therefore, more pleasant to use. | |2. Looking at the output, it is my opinion that TeX produces |better-looking documents. Perhaps this is just no more than one man's |esthetic opinion. I do not know what it is that I find better. It's just |the sense I get. On the other hand, I find troff output to be sufficiently |good in nearly all cases. Note that heirloom doctools (on github) is a SysV-derived *roff codebase which has been extended to use TeX paragraph algorithm, font kerning, true type fonts, etc. You need to explicitly code your macros to use these features. |3. troff is a good and reasonable tool. TeX is too big and complex an |environment in most cases. Although it is true that all of the complexity |of the TeX environment is successfully hidden in virtually all cases. I |find the huge and complex environment offputting. That is overly not true. You can start off with nothing but what TeX loads by default, plus epsf.tex and maybe colordvi.tex for some use cases and you have everything you need. I have never used it, but there is kertex and i am tracking it since, eh, July 2012. It is maintained. It is just the bare core, but includes more than i ever needed #?0|kent:kertex.tar_bomb_git$ git loca|wc -l 20 #?0|kent:kertex.tar_bomb_git$ du -sh . 13M . |Very unfortunately, I see troff disappearing. I've worked with a number of |teams over the last ten years. In every case, I was the oldest engineer. |Also, in each case, I was the only engineer who had even heard of troff. |They understand the problems of binary formats such as Word and |OpenOffice. Their solutions are things like markdown, AsciiDoc, et al. |They are doing this development and making use of these tools without |knowledge of troff. The same is true to a greater or lesser degree with |TeX, except that I've seen TeX used at universities. | |I like that groff and TeX are rock solid and well supported. In fact, I |wrote a report generator for a modern web development framework using |troff. I use it to develop reports on a routine basis. (kissweb.org) |Sadly, however, if word of their existence doesn't get out there, I see |them both disappearing in not much longer than a generation. This would be |sad indeed. Gee, the current hip top of the pops is to not even include generated documentation in release tarballs no more! Heck, i even know a project that took a year-long-not-modified manual page and converted it into some so-called text format. It thus needs a software which happily announces itself as "ronn: the opposite of roff", yieha! I mean ruby ok, there are some such tools which require Haskell, which in turn requires a binary runtime package (or a huuuuge source ball). No no, really not. I mean really. You develop it, you decide it is time for a release, you do test the convertability do you, why not include the 10 kilobytes for your is-anyway-almost-a-stub manual?? In fact these balls nowadays include .github subirectories for github workflows, which is much larger than the manual. Sigh. --steffen | |Der Kragenbaer, The moon bear, |der holt sich munter he cheerfully and one by one |einen nach dem anderen runter wa.ks himself off |(By Robert Gernhardt)