From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.help Subject: Re: outline-minor-mode and org-mode capabilities for programming languages Date: Tue, 11 May 2021 04:00:49 +0200 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="18719"; mail-complaints-to="usenet@ciao.gmane.io" Cc: help-gnu-emacs@gnu.org To: Jean Louis Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Tue May 11 04:03:19 2021 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lgHjx-0004ll-TM for geh-help-gnu-emacs@m.gmane-mx.org; Tue, 11 May 2021 04:03:17 +0200 Original-Received: from localhost ([::1]:33032 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lgHjw-0006hc-UF for geh-help-gnu-emacs@m.gmane-mx.org; Mon, 10 May 2021 22:03:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50106) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lgHi8-0005Yw-JU for help-gnu-emacs@gnu.org; Mon, 10 May 2021 22:01:24 -0400 Original-Received: from mout.gmx.net ([212.227.15.15]:57445) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lgHi6-0008LQ-7E for help-gnu-emacs@gnu.org; Mon, 10 May 2021 22:01:24 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1620698449; bh=/i67137mjXQ3U7wFfwR/5Qrpy1JLTty89IPdMfAYhDo=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=gO2LijJ6npjva8ZIhQB9SS8gReaJMcz02crhMWSP0LmDFnvUm9ij9bN4bQicxdPUU 4PrVwovJb7NqGdC8/EcGf5M9h/vvo32YtZ7Jc5dR1qbEi/HUAfADT25dyfKHWyvkgc dZOfqxO0VgcVdneKWzEL52L8y6oI7bjoZRdOScWA= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [213.165.168.94] ([213.165.168.94]) by web-mail.gmx.net (3c-app-mailcom-bs03.server.lan [172.19.170.169]) (via HTTP); Tue, 11 May 2021 04:00:49 +0200 Importance: normal Sensitivity: Normal In-Reply-To: X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:9G/tjD2aoh4aZCEkArviSAGBePCXBuqKL+iPZ4GducCIIWzL8FtnjIUwKgqxYfgpOMgt9 1qqRR0GhS9G+JfOPQfmLlSmJSjFYYaciFbz4ZkyTzfL/GjVrKqDsfsXPUaiE9Uh3A8HBzRw8xNE/ CmpbJhqBgMV8wkNWPuzU/ZlJoqkf42/dmLQ0Zll7T5Eg3yLQRbiPyWilVoxB2Qh7kdiGU3kf9f+Q UgfHa8bfZv4/6hma/8gJQ+WCRvxCNhjWZIxJic7wBS7fyJi51tUhhcRiYXGIZWX81G86VWN+nQlN HQ= X-UI-Out-Filterresults: notjunk:1;V03:K0:yURXSWdY60E=:K9WWuGb2q/G7A970M2c5oA liyDIzffRdMrkJYppIQlLCACIdvcmKJBq3y9ER12a+jWmO2MNoLgH3Rrbhl4CaGmvFLgJNqFi X9fPF9wVLyv+H+1o+QZO9vzad7g0IjkKnLtSlVl0daSy/wBzAk41MWWbZfi1u+t+vw4yDe2Zd KM2+GXASEAxkm1lBSxy2cvcxp1KHlQqLmXVmzNeKq5rRfNfccfRA4MjFYjUsnaaqJGvR7y7IE eX3hJvspS338PfLiYI1YX6RjesdK+7QEw1d5g3xV17fc+c9f3UBjUXHzAm3ZWuE+R5/Ve76xi 8pc++oIHy3fZ7bK+jmJkWMtI1UqJ5lY8Dr0UIhKpUUEaflBW6PucprAiZwfrgIbCu10GGe7FY ocm1UBPMDKlSxpc5pUWKxCVglmbttUODOgK7oaPJVkh23V0Qd6j7DvDmfxU7SZ0uJVjeelwe0 961gv2u448dK8VRS8w4LGzzhTie6OTAAo/S/gZWtfxjeDsqHfS+C0yjAlisMAt0ebIB2v7hMt vq326oF75yyaJX3R3tRrAdXd6YXRWXOXa1x1gvHOd8CaJdJjNQlwLIUVPsfoZXXTnryAkvNbY DYdEVtz7Yg3b1Tu/dIAgbSYCXc4Z+Fd/2m+MUljsrZLx0lIpkrkPeb2M4dDqV0T5g0DMcwJS7 ae3VWi5bTVa2+FuMtaPFyfSZjqtz27Qi8JMXx27YuVhPfXfZZfD9DjvUgrWkvOxlI7rB0wQhH HUhyuUd4G+qXC1YHXAsgwT/yJv7xmJpqZLK+eU3nVvvJHasXIHFcCZKUBPhBy4sbY8IQHj/o Received-SPF: pass client-ip=212.227.15.15; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:129674 Archived-At: > Sent: Tuesday, May 11, 2021 at 5:05 AM > From: "Jean Louis" > To: "Christopher Dimech" > Cc: help-gnu-emacs@gnu.org > Subject: Re: outline-minor-mode and org-mode capabilities for programmin= g languages > > * Christopher Dimech [2021-05-10 15:53]: > > > How about instead of embedding code in the text, to embed text in th= e > > > code? > > > > Originally I had bought in the idea of Knuth and others, but did not > > buy on their results with literate programming. What I find > > valuable is the the development of protowriting that communicates > > limited information. They maybe a parser that goes through the to > > obtain a more literate translation. > > Simple Way to Document Code with Markdown, grep, and pandoc | Richard Za= ch > https://people.ucalgary.ca/~rzach/blog/2014/05/simple-way-to-document-co= de-with-markdown-grep-and-pandoc.html > > Basically, few shell tools and a workflow may replace all the > "literate programming" tools there are. Just write the markup in > comments, and pre-process the file with `cut', `grep', etc. to > generate output. > > > > That is where embedding text into the code comes in. There need not = be > > > visible text in the code, but one could click and get the same > > > function elaborated with the markup source, markup result such as PD= F, > > > and one could jump back to the code. > > > > The strategy of hiding is good. But I promote the idea of having sepa= rate > > files. Documentation in code will be limited, more elaborate schemes = for > > documunetation on a separate file. Most times the code is the place t= o check > > things. > > That can be done by method using GNU Hyperbole or principle of it, > just make each (defun ) or (defvar ) and maybe functions a button that > points to something else, editable. > > Right now if I use M-RET with GNU Hyperbole it brings me to definition > of a function, and often it works better than M-. that brings me also > to definitions, but it will not find it at all times. > > > > In other words, don't make it too literate for illiterates. > > > > There has to be a background and foundation. For instance, > > magnetism is one of those things that's just too difficult to > > understand, except through an elaborate education in physics. In > > computing, we have not arrived at that stage yet. > > Back in time we were making programs for schools that were very > helpful for pupils to learn physics. We don't have much of it today. I remember those - doing electical circuits, linear motion, etc. Were coo= l stuff. > -- > Jean > > Take action in Free Software Foundation campaigns: > https://www.fsf.org/campaigns > > Sign an open letter in support of Richard M. Stallman > https://stallmansupport.org/ > https://rms-support-letter.github.io/ > >