From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from minnie.tuhs.org (minnie.tuhs.org [45.79.103.53]) by inbox.vuxu.org (OpenSMTPD) with ESMTP id b4a6e374 for ; Tue, 18 Feb 2020 12:29:24 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id 5AA6F9D52A; Tue, 18 Feb 2020 22:29:23 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 7D55C9D51B; Tue, 18 Feb 2020 22:29:02 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id F0BC69D518; Tue, 18 Feb 2020 22:29:00 +1000 (AEST) Received: from freefriends.org (freefriends.org [96.88.95.60]) by minnie.tuhs.org (Postfix) with ESMTPS id 1193F9CD7A for ; Tue, 18 Feb 2020 22:28:59 +1000 (AEST) X-Envelope-From: arnold@skeeve.com Received: from freefriends.org (freefriends.org [96.88.95.60]) by freefriends.org (8.14.7/8.14.7) with ESMTP id 01ICS1c8020952 (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 18 Feb 2020 05:28:01 -0700 Received: (from arnold@localhost) by freefriends.org (8.14.7/8.14.7/Submit) id 01ICS1pj020951; Tue, 18 Feb 2020 05:28:01 -0700 From: arnold@skeeve.com Message-Id: <202002181228.01ICS1pj020951@freefriends.org> X-Authentication-Warning: frenzy.freefriends.org: arnold set sender to arnold@skeeve.com using -f Date: Tue, 18 Feb 2020 05:28:01 -0700 To: tuhs@tuhs.org, rdm@cfcl.com References: <202002171520.01HFKqKi026749@tahoe.cs.Dartmouth.EDU> <4d252035b323b7583c5760c952d1982c@firemail.de> <202002171839.01HId8FT1358073@darkstar.fourwinds.com> <202002180017.01I0HI0I1415945@darkstar.fourwinds.com> In-Reply-To: User-Agent: Heirloom mailx 12.5 7/5/10 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Subject: Re: [TUHS] man Macro Package and pdfmark 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: , Errors-To: tuhs-bounces@minnie.tuhs.org Sender: "TUHS" Rich Morin wrote: > Lately, I've been using the built-in documentation tools for Elixir, > a functional programming language based on the Erlang VM and a lot > of Ruby syntax. I'm pleased to say that it's really quite pleasant. > > I create multi-line "attributes" using macros such as @doc. These > are encoded using Markdown, which isn't perfect but seems adequate. > The results are converted into both HTML pages and interactive help > text, with automagical indexing. This sounds something like a poor man's version of Literate Programming, invented by Donald Knuth for TeX et al. That's another technology that I happen to like personally, but which never became mainstream. More's the pity (IMHO). (I do know about Doug's review of DEK's program in the Programming Pearls column. I think the problems there were not with Lit Prog itself, but with how Knuth programs. My own take on Literate Programming can be seen at https://github.com/arnoldrobbins/texiwebjr.) Yes, probably getting off topic, too. Arnold