From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp1 ([2001:41d0:8:6d80::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms0.migadu.com with LMTPS
	id uHdSGRF6WWGgLQAAgWs5BA
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Sun, 03 Oct 2021 11:38:25 +0200
Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp1 with LMTPS
	id GKINFRF6WWEIQwAAbx9fmQ
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Sun, 03 Oct 2021 09:38:25 +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 C824F12CDF
	for <larch@yhetil.org>; Sun,  3 Oct 2021 11:38:24 +0200 (CEST)
Received: from localhost ([::1]:32774 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	id 1mWxwt-0008ED-UJ
	for larch@yhetil.org; Sun, 03 Oct 2021 05:38:23 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:49674)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <yantar92@gmail.com>)
 id 1mWxvT-0008AZ-9H
 for emacs-orgmode@gnu.org; Sun, 03 Oct 2021 05:36:55 -0400
Received: from mail-pl1-x62a.google.com ([2607:f8b0:4864:20::62a]:44690)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <yantar92@gmail.com>)
 id 1mWxvR-0002MW-Rh
 for emacs-orgmode@gnu.org; Sun, 03 Oct 2021 05:36:54 -0400
Received: by mail-pl1-x62a.google.com with SMTP id t11so9122948plq.11
 for <emacs-orgmode@gnu.org>; Sun, 03 Oct 2021 02:36:53 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=from:to:cc:subject:in-reply-to:references:date:message-id
 :mime-version; bh=GO3d7aNtjRhMLmfATKdiV5zH6/6Vjokhn8y4hPvHVNY=;
 b=LW5pxtbM1bsK6nRlc8VO9SO3QHWqA8sdhG9vDukae5c2pQkheBS4NH0ZUPvf6OCp2V
 YEW6KC6BnOg43RxBDMlG9yKLHMRsg08KdmddxmwJTv1QxIKopeE+1bHRYdg7ADig6SwZ
 PGUyysRvHSLmcf5de4Cxyu6R4Qm39z9vWSJ5wP13VGUmX5pB7v+SrBJ2UhVxGSkMurA+
 unWAm6wo3I9bNPW2R4kBvBDhVoWlt18sdPsYCZpK29aj5UuumYJ+NcJvsS8uJ81q7F74
 hli0AdKQvtIXgZMSyxXbclKWj+vW3LENobEfLazen52LWgbvrG/knFQFwVzTJjPyg7sz
 2aOw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date
 :message-id:mime-version;
 bh=GO3d7aNtjRhMLmfATKdiV5zH6/6Vjokhn8y4hPvHVNY=;
 b=eKU32nNo5Xj6QrTTe3W4lz3L1gkBUGW7iMWWD7ch1QV9ao4Tjj/YtQs1zmN0TNBZs4
 fNSHmw5M22Pp3p5zDGM26YsMeF+V2dluSAp5EN9nn740zK/JXZT7lAOZz1mVgSdCDQAP
 cgia0iWNvkDkbEoXDebcn7xtQ8tStDif2NaRtrVjUlrwVJ87lv5lb/epRjr/NPYOMOdX
 4Gy4n4RLFlcERu+b9v27qjeM8o9c9JSqpkQRXtGYfbWlhhoIO9Y80DDzIqlCjBO4bej8
 q8CJEd74X6kZCZ9L5LNi2XNLmpOAHObMYz71HlpZXTjD905WcEJxTXR8KCKQ5DjhH+hu
 eItA==
X-Gm-Message-State: AOAM533QCtXfdbnQpzTM7QThXtpet8NO9sCwKdp78l+EJawOu7+AayyZ
 MP30q7hGVminnQqUdStD9BP25TzwyyIN8g7j
X-Google-Smtp-Source: ABdhPJzdTQcZYFdpW/qCOtIYvPFCipcXG/7rXbt8Yb9ZdukNgxE9GhPjkeVmB3TH4Hrh4Uf4IUEj5Q==
X-Received: by 2002:a17:902:d506:b0:13e:4ac4:b52 with SMTP id
 b6-20020a170902d50600b0013e4ac40b52mr18090889plg.88.1633253812411; 
 Sun, 03 Oct 2021 02:36:52 -0700 (PDT)
Received: from localhost (61-219-114-7.hinet-ip.hinet.net. [61.219.114.7])
 by smtp.gmail.com with ESMTPSA id l185sm10978902pfd.29.2021.10.03.02.36.51
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Sun, 03 Oct 2021 02:36:51 -0700 (PDT)
From: Ihor Radchenko <yantar92@gmail.com>
To: Kodi Arfer <listu@arfer.net>
Subject: Re: How is the return value of `org-babel-execute:FOO` interpreted?
In-Reply-To: <801012e5-9500-d5b8-b772-4a2df92f200e@arfer.net>
References: <801012e5-9500-d5b8-b772-4a2df92f200e@arfer.net>
Date: Sun, 03 Oct 2021 17:38:10 +0800
Message-ID: <87bl46e9dp.fsf@localhost>
MIME-Version: 1.0
Content-Type: text/plain
Received-SPF: pass client-ip=2607:f8b0:4864:20::62a;
 envelope-from=yantar92@gmail.com; helo=mail-pl1-x62a.google.com
X-Spam_score_int: -17
X-Spam_score: -1.8
X-Spam_bar: -
X-Spam_report: (-1.8 / 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,
 FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001,
 RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=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." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Cc: emacs-orgmode@gnu.org
Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
Sender: "Emacs-orgmode" <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
X-Migadu-Flow: FLOW_IN
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org;
	s=key1; t=1633253905;
	h=from:from:sender:sender:reply-to:subject:subject:date:date:
	 message-id:message-id:to:to:cc:cc:mime-version:mime-version:
	 content-type:content-type:in-reply-to:in-reply-to:
	 references:references:list-id:list-help:list-unsubscribe:
	 list-subscribe:list-post:dkim-signature;
	bh=GO3d7aNtjRhMLmfATKdiV5zH6/6Vjokhn8y4hPvHVNY=;
	b=GzXJ4kT1jn+GA8NDT1kzcQ62TAcInU8PR2kxU8+t/13sbctb/GREvOXJHMJMTUguCDQsAL
	ThOJZONbYZamdl3Nb3nT8gvo3PqV7X9LYm8kbMnc41QRTIFyFecE4BXplq/m7j95NiIrR9
	FXBbbOImtR5JSPei+lDIYkmM+pTif1sR1fQZsvif55Kw+gW4ulv8bGXFTqRRJamZphC1Mh
	13Z5LmypKLO++Z3cILcZDW+UnLXBCDoiNqL/42iE7vbOrRT105uXR5OtCWJswWB6sZ5Mpn
	dN7MBvXTaC00IM3/3CSQU9fIgXfUBmFFxfU80b2bEUBP8ApNs++32gd9/t0Ewg==
ARC-Seal: i=1; s=key1; d=yhetil.org; t=1633253905; a=rsa-sha256; cv=none;
	b=mkcv+ggZhRxo8GEQj+F4hMM+PT+075iYU6oX5D/1HruteFUUdEGGipf0rzLGEO3YGE2pxC
	1RjuiGnhdqhokd36T0xNP8b73CGasilNFqxKXrvOcP3vzA370pAx3dpyKwwDR/cpigk6Nj
	NfyUZ8OEx078QqwCm59kY6Hk3TCpr8aO0vv9ne0d014Yyi7NFr+T5n5kUnkacKoBY679KF
	ytvIBSYZNLMZc1GdA0a0jQfVpAFXVxJsDBxGsKPzWjiI5xv3ybSlmOXm7Wd2yP16nOjreV
	NYSN3mpGDvH2JXPiNgNiLmMLdsVtYF25659x6rrGbojdEvnN7MX5jPa7HBRzUA==
ARC-Authentication-Results: i=1;
	aspmx1.migadu.com;
	dkim=pass header.d=gmail.com header.s=20210112 header.b=LW5pxtbM;
	dmarc=pass (policy=none) header.from=gmail.com;
	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-Migadu-Spam-Score: -1.61
Authentication-Results: aspmx1.migadu.com;
	dkim=pass header.d=gmail.com header.s=20210112 header.b=LW5pxtbM;
	dmarc=pass (policy=none) header.from=gmail.com;
	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-Migadu-Queue-Id: C824F12CDF
X-Spam-Score: -1.61
X-Migadu-Scanner: scn0.migadu.com
X-TUID: 95J+EqnmklEj

Kodi Arfer <listu@arfer.net> writes:

> I have an `org-babel-execute` function for the Hy programming language that seems to have partly broken when I upgraded Org (from 9.1.14 to 9.4.6). It has code to write a plot to a file when a `:file` argument is given to the code block. It returns `nil` in this case, and previously, Org would automatically insert a link to the file in the results block, as desired. Now, however, the `nil` is printed in the results block. So I guess have to edit the function to return a link instead, but I can't find documentation for how Org interprets the return value of an `org-babel-execute` function: as I vaguely recall, you have to use a certain cons structure to produce a table, another to produce a link, and so on. So the concrete question in this case is: what do I return to put a link in the document?

I just tested using ob-gnuplot and :file link is correctly inserted when
org-babel-execute:gnuplot returns nil.

Are you sure that you have :file parameter in the source block you tried
to execute?

Best,
Ihor