Re: How is the return value of `org-babel-execute:FOO` interpreted?

[Ihor Radchenko <yantar92@gmail.com>]

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