From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id QAdbMEPCvl9IBQAA0tVLHw (envelope-from ) for ; Wed, 25 Nov 2020 20:44:51 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id +Pc4LEPCvl+MFgAAB5/wlQ (envelope-from ) for ; Wed, 25 Nov 2020 20:44:51 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 0CEE8940111 for ; Wed, 25 Nov 2020 20:44:50 +0000 (UTC) Received: from localhost ([::1]:45126 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ki1ei-0003XF-AB for larch@yhetil.org; Wed, 25 Nov 2020 15:44:48 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:49522) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ki1eH-0003Ww-19 for emacs-orgmode@gnu.org; Wed, 25 Nov 2020 15:44:21 -0500 Received: from grinta.net ([109.74.203.128]:33524) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ki1eE-0007RX-D0 for emacs-orgmode@gnu.org; Wed, 25 Nov 2020 15:44:20 -0500 Received: from black.local (p5dd0dc2f.dip0.t-ipconnect.de [93.208.220.47]) (Authenticated sender: daniele) by grinta.net (Postfix) with ESMTPSA id 4CD65EE9BA; Wed, 25 Nov 2020 20:44:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=grinta.net; s=2020; t=1606337055; bh=WOZfFNiZCEITAQc8bbQ3IosOujXVrCoklFAw/vZcB30=; h=Subject:To:Cc:References:From:Date:In-Reply-To:From; b=nZ5sPu0BMyVlvFN0knIhaLEKZs37oT7V4+KLGDpdN2Gcj0YxadNOXnpuDUKnUWi0K LOZZGQLTm4t/dDwLPcKib/WGckCjK/mtEVrUng+T1ODxxWEIgjSbMbc+ayipUrbA3o RL/OME15Db31jBdq3hvN0dLTGojABK75KCDsCxh2b1pZVTGmD1qzyru7U99zom3q1u 2lmkfX0HfWuapITp2F3ayJUXOicRlkuEgG9BHBAN+dbEwXPQZWkL4TR3cmgKoxKqHU OaeFIm5iwpOVUwgNuolM+C1STDE/uKiHwcERKUgI0zs5No3Q/OA05teW0aDh4gwuGa 8PENSb8V9Wf0w== Subject: Re: [PATCH] doc/org-manual.org: Extend table formulas Lisp form documentation To: Kyle Meyer References: <87im9u832j.fsf@kyleam.com> From: Daniele Nicolodi Message-ID: <932e0bdf-4738-ad95-64fd-e7cd6ea660e6@grinta.net> Date: Wed, 25 Nov 2020 21:44:12 +0100 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:78.0) Gecko/20100101 Thunderbird/78.5.0 MIME-Version: 1.0 In-Reply-To: <87im9u832j.fsf@kyleam.com> Content-Type: multipart/mixed; boundary="------------C0B0D542D1166987BFC89297" Content-Language: en-US Received-SPF: pass client-ip=109.74.203.128; envelope-from=daniele@grinta.net; helo=grinta.net X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, NICE_REPLY_A=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Org Mode List Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Scanner: ns3122888.ip-94-23-21.eu Authentication-Results: aspmx1.migadu.com; dkim=fail (headers rsa verify failed) header.d=grinta.net header.s=2020 header.b=nZ5sPu0B; dmarc=none; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Spam-Score: 2.09 X-TUID: cN4i19641+Hp This is a multi-part message in MIME format. --------------C0B0D542D1166987BFC89297 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit On 25/11/2020 05:37, Kyle Meyer wrote: > Daniele Nicolodi writes: > >> Hello, >> >> I always found the description of Lisp forms in Org table formulas not >> extremely clear, especially in regard to the use of mode flags. The >> attached patch tries to clarify the manual a bit. > > Thanks. Thank you for the review, Kyle. An updated patch is attached. >> Would it be worth to mention org-sbe in the same section of the manual? > > Yeah, it looks like there's no mention of org-sbe in the manual, so I > think so (as a separate patch). After playing a bit with org-sbe, I came to the conclusion that it is broken beyond repair, at least without breaking it for the people that managed to make it work for them. I think that adding mention of it in the manual and explain all the quirks of the macro is much more work than replace it with something better. I tried to write a better macro, please have a look here: https://orgmode.org/list/d429d29b-42fa-7d7b-6f3a-9fe692fd6dc7@grinta.net/ and the parent message for an explanation of what I think is broken in org-sbe. Would you support adding org-sbx (for a lack of a better name) to ob-table.el and mention it in the manual instead of org-sbe? I would not go as far as deprecating org-sbe, just yet, but maybe soon... Cheers, Dan --------------C0B0D542D1166987BFC89297 Content-Type: text/plain; charset=UTF-8; x-mac-type="0"; x-mac-creator="0"; name="0001-doc-org-manual.org-Extend-table-formulas-Lisp-form-d.patch" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename*0="0001-doc-org-manual.org-Extend-table-formulas-Lisp-form-d.pa"; filename*1="tch" RnJvbSBkMzllYzQ0NjU2MDVmNTZkNWY1M2EzNmZhZjRlNDE5YWUxYjg2MmYwIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBEYW5pZWxlIE5pY29sb2RpIDxkYW5pZWxlQGdyaW50 YS5uZXQ+CkRhdGU6IFNhdCwgMTQgTm92IDIwMjAgMTg6MzM6NDEgKzAxMDAKU3ViamVjdDog W1BBVENIXSBkb2Mvb3JnLW1hbnVhbC5vcmc6IEV4dGVuZCB0YWJsZSBmb3JtdWxhcyBMaXNw IGZvcm0KIGRvY3VtZW50YXRpb24KCmRvYy9vcmctbWFudWFsLm9yZyAoRW1hY3MgTGlzcCBm b3JtcyBhcyBmb3JtdWxhcyk6IEJlIG1vcmUKZXhwbGljaXQgYWJvdXQgaG93IGZpZWxkcyBh cmUgaW50ZXJwb2xhdGVkIGludG8gdGhlIExpc3AgZm9ybXMsCmNsYXJpZnkgdGhlIHVzZSBv ZiBtb2RlIGZsYWdzLCBhbmQgYWRkIGEgY291cGxlIG1vcmUgZXhhbXBsZXMuCi0tLQogZG9j L29yZy1tYW51YWwub3JnIHwgNjQgKysrKysrKysrKysrKysrKysrKysrKysrKysrKystLS0t LS0tLS0tLS0tLS0tLQogMSBmaWxlIGNoYW5nZWQsIDQwIGluc2VydGlvbnMoKyksIDI0IGRl bGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9vcmctbWFudWFsLm9yZyBiL2RvYy9vcmct bWFudWFsLm9yZwppbmRleCAyZjdmNWY4NDcuLjk3MDE4ZDA3NSAxMDA2NDQKLS0tIGEvZG9j L29yZy1tYW51YWwub3JnCisrKyBiL2RvYy9vcmctbWFudWFsLm9yZwpAQCAtMjE3OCwzOCAr MjE3OCw1NCBAQCBJdCBpcyBhbHNvIHBvc3NpYmxlIHRvIHdyaXRlIGEgZm9ybXVsYSBpbiBF bWFjcyBMaXNwLiAgVGhpcyBjYW4gYmUKIHVzZWZ1bCBmb3Igc3RyaW5nIG1hbmlwdWxhdGlv biBhbmQgY29udHJvbCBzdHJ1Y3R1cmVzLCBpZiBDYWxjJ3MKIGZ1bmN0aW9uYWxpdHkgaXMg bm90IGVub3VnaC4KIAotSWYgYSBmb3JtdWxhIHN0YXJ0cyB3aXRoIGEgc2luZ2xlLXF1b3Rl IGZvbGxvd2VkIGJ5IGFuIG9wZW5pbmcKLXBhcmVudGhlc2lzLCB0aGVuIGl0IGlzIGV2YWx1 YXRlZCBhcyBhIExpc3AgZm9ybS4gIFRoZSBldmFsdWF0aW9uCi1zaG91bGQgcmV0dXJuIGVp dGhlciBhIHN0cmluZyBvciBhIG51bWJlci4gIEp1c3QgYXMgd2l0aCBDYWxjCi1mb3JtdWxh cywgeW91IGNhbiBzcGVjaWZ5IG1vZGVzIGFuZCBhIH5wcmludGZ+IGZvcm1hdCBhZnRlcgot YSBzZW1pY29sb24uCitBIGZvcm11bGEgaXMgZXZhbHVhdGVkIGFzIGEgTGlzcCBmb3JtIHdo ZW4gaXQgc3RhcnRzIHdpdGggYQorc2luZ2xlLXF1b3RlIGZvbGxvd2VkIGJ5IGFuIG9wZW5p bmcgcGFyZW50aGVzaXMuICBDZWxsIHRhYmxlCityZWZlcmVuY2VzIGFyZSBpbnRlcnBvbGF0 ZWQgaW50byB0aGUgTGlzcCBmb3JtIGJlZm9yZSBleGVjdXRpb24uICBUaGUKK2V2YWx1YXRp b24gc2hvdWxkIHJldHVybiBlaXRoZXIgYSBzdHJpbmcgb3IgYSBudW1iZXIuICBFdmFsdWF0 aW9uCittb2RlcyBhbmQgYSB+cHJpbnRmfiBmb3JtYXQgdXNlZCB0byByZW5kZXIgdGhlIHJl dHVybmVkIHZhbHVlcyBjYW4gYmUKK3NwZWNpZmllZCBhZnRlciBhIHNlbWljb2xvbi4KIAot V2l0aCBFbWFjcyBMaXNwIGZvcm1zLCB5b3UgbmVlZCB0byBiZSBjb25zY2lvdXMgYWJvdXQg dGhlIHdheSBmaWVsZAotcmVmZXJlbmNlcyBhcmUgaW50ZXJwb2xhdGVkIGludG8gdGhlIGZv cm0uICBCeSBkZWZhdWx0LCBhIHJlZmVyZW5jZSBpcwotaW50ZXJwb2xhdGVkIGFzIGEgTGlz cCBzdHJpbmcgKGluIGRvdWJsZS1xdW90ZXMpIGNvbnRhaW5pbmcgdGhlIGZpZWxkLgotSWYg eW91IHByb3ZpZGUgdGhlID1OPSBtb2RlIHN3aXRjaCwgYWxsIHJlZmVyZW5jZWQgZWxlbWVu dHMgYXJlCi1udW1iZXJzLS0tbm9uLW51bWJlciBmaWVsZHMgd2lsbCBiZSB6ZXJvLS0tYW5k IGludGVycG9sYXRlZCBhcyBMaXNwCi1udW1iZXJzLCB3aXRob3V0IHF1b3Rlcy4gIElmIHlv dSBwcm92aWRlIHRoZSA9TD0gZmxhZywgYWxsIGZpZWxkcyBhcmUKLWludGVycG9sYXRlZCBs aXRlcmFsbHksIHdpdGhvdXQgcXVvdGVzLiAgRm9yIGV4YW1wbGUsIGlmIHlvdSB3YW50IGEK LXJlZmVyZW5jZSB0byBiZSBpbnRlcnByZXRlZCBhcyBhIHN0cmluZyBieSB0aGUgTGlzcCBm b3JtLCBlbmNsb3NlIHRoZQotcmVmZXJlbmNlIG9wZXJhdG9yIGl0c2VsZiBpbiBkb3VibGUt cXVvdGVzLCBsaWtlID0iJDMiPS4gIFJhbmdlcyBhcmUKLWluc2VydGVkIGFzIHNwYWNlLXNl cGFyYXRlZCBmaWVsZHMsIHNvIHlvdSBjYW4gZW1iZWQgdGhlbSBpbiBsaXN0IG9yCi12ZWN0 b3Igc3ludGF4LgorQnkgZGVmYXVsdCwgcmVmZXJlbmNlcyBhcmUgaW50ZXJwb2xhdGVkIGFz IGxpdGVyYWwgTGlzcCBzdHJpbmdzOiB0aGUKK2ZpZWxkIGNvbnRlbnQgaXMgcmVwbGFjZWQg aW4gdGhlIExpc3AgZm9ybSBzdHJpcHBlZCBvZiBsZWFkaW5nIGFuZAordHJhaWxpbmcgd2hp dGUgc3BhY2UgYW5kIHN1cnJvdW5kZWQgaW4gZG91YmxlLXF1b3Rlcy4gIEZvciBleGFtcGxl OgogCi1IZXJlIGFyZSBhIGZldyBleGFtcGxlcy0tLW5vdGUgaG93IHRoZSA9Tj0gbW9kZSBp cyB1c2VkIHdoZW4gd2UgZG8KLWNvbXB1dGF0aW9ucyBpbiBMaXNwOgorOiAnKGNvbmNhdCAk MSAkMikKIAotLSA9Jyhjb25jYXQgKHN1YnN0cmluZyAkMSAxIDIpIChzdWJzdHJpbmcgJDEg MCAxKSAoc3Vic3RyaW5nICQxIDIpKT0gOjoKKyMrdGV4aW5mbzogQG5vaW5kZW50Citjb25j YXRlbmF0ZXMgdGhlIGNvbnRlbnQgb2YgY29sdW1ucyAxIGFuZCBjb2x1bW4gMi4KKworV2hl biB0aGUgPU49IGZsYWcgaXMgdXNlZCwgYWxsIHJlZmVyZW5jZWQgZWxlbWVudHMgYXJlIHBh cnNlZCBhcworbnVtYmVycyBhbmQgaW50ZXJwb2xhdGVkIGFzIExpc3AgbnVtYmVycywgd2l0 aG91dCBxdW90ZXMuIEZpZWxkcyB0aGF0CitjYW5ub3QgYmUgcGFyc2VkIGFzIG51bWJlcnMg YXJlIGludGVycG9sYXRlZCBhcyB6ZXJvcy4gIEZvciBleGFtcGxlOgorCis6ICcoKyAkMSAk Mik7TgorCisjK3RleGluZm86IEBub2luZGVudAorYWRkcyBjb2x1bW5zIDEgYW5kIDIsIGVx dWl2YWxlbnQgdG8gQ2FsYydzID0kMSskMj0uICBSYW5nZXMgYXJlCitpbnNlcnRlZCBhcyBz cGFjZS1zZXBhcmF0ZWQgZmllbGRzLCBzbyB0aGV5IGNhbiBiZSBlbWJlZGRlZCBpbiBsaXN0 IG9yCit2ZWN0b3Igc3ludGF4LiBGb3IgZXhhbXBsZToKIAotICBTd2FwIHRoZSBmaXJzdCB0 d28gY2hhcmFjdGVycyBvZiB0aGUgY29udGVudCBvZiBjb2x1bW4gMS4KKzogJyhhcHBseSAn KyAnKCQxLi4kNCkpO04KIAotLSA9JygrICQxICQyKTtOPSA6OgorIyt0ZXhpbmZvOiBAbm9p bmRlbnQKK2NvbXB1dGVzIHRoZSBzdW0gb2YgY29sdW1ucyAxIHRvIDQsIGxpa2UgQ2FsYydz ID12c3VtKCQxLi4kNCk9LgorCitXaGVuIHRoZSA9TD0gZmxhZyBpcyB1c2VkLCBhbGwgZmll bGRzIGFyZSBpbnRlcnBvbGF0ZWQgbGl0ZXJhbGx5OiB0aGUKK2NlbGwgY29udGVudCBpcyBy ZXBsYWNlZCBpbiB0aGUgTGlzcCBmb3JtIHN0cmlwcGVkIG9mIGxlYWRpbmcgYW5kCit0cmFp bGluZyB3aGl0ZSBzcGFjZSBhbmQgd2l0aG91dCBxdW90ZXMuICBJZiBhIHJlZmVyZW5jZSBp cyBpbnRlbmRlZAordG8gYmUgaW50ZXJwcmV0ZWQgYXMgYSBzdHJpbmcgYnkgdGhlIExpc3Ag Zm9ybSwgdGhlIHJlZmVyZW5jZSBvcGVyYXRvcgoraXRzZWxmIHNob3VsZCBiZSBlbmNsb3Nl ZCBpbiBkb3VibGUtcXVvdGVzLCBsaWtlID0iJDMiPS4gIFRoZSA9TD0gZmxhZworaXMgdXNl ZnVsIHdoZW4gc3RyaW5ncyBhbmQgbnVtYmVycyBhcmUgdXNlZCBpbiB0aGUgc2FtZSBMaXNw IGZvcm0uICBGb3IKK2V4YW1wbGU6CiAKLSAgQWRkIGNvbHVtbnMgMSBhbmQgMiwgZXF1aXZh bGVudCB0byBDYWxjJ3MgPSQxKyQyPS4KKzogJyhzdWJzdHJpbmcgIiQxIiAkMiAkMyk7TAog Ci0tID0nKGFwcGx5ICcrICcoJDEuLiQ0KSk7Tj0gOjoKKyMrdGV4aW5mbzogQG5vaW5kZW50 CitleHRyYWN0cyB0aGUgcGFydCBvZiB0aGUgc3RyaW5nIGluIGNvbHVtbiAxIGJldHdlZW4g dGhlIGNoYXJhY3RlcgorcG9zaXRpb25zIHNwZWNpZmllZCBpbiB0aGUgaW50ZWdlcnMgaW4g Y29sdW1uIDIgYW5kIDMgYW5kIGl0IGlzIGVhc2llcgordG8gcmVhZCB0aGFuIHRoZSBlcXVp dmFsZW50OgogCi0gIENvbXB1dGUgdGhlIHN1bSBvZiBjb2x1bW5zIDEgdG8gNCwgbGlrZSBD YWxjJ3MgPXZzdW0oJDEuLiQ0KT0uCis6ICcoc3Vic3RyaW5nICQxIChzdHJpbmctdG8tbnVt YmVyICQyKSAoc3RyaW5nLXRvLW51bWJlciAkMykpCiAKICoqKiBEdXJhdGlvbnMgYW5kIHRp bWUgdmFsdWVzCiA6UFJPUEVSVElFUzoKLS0gCjIuMjkuMgoK --------------C0B0D542D1166987BFC89297--