From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id CIO5BlUDIV8IewAA0tVLHw (envelope-from ) for ; Wed, 29 Jul 2020 05:04:21 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id mO1oAlUDIV8zQQAAbx9fmQ (envelope-from ) for ; Wed, 29 Jul 2020 05:04:21 +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 00872940225 for ; Wed, 29 Jul 2020 05:04:19 +0000 (UTC) Received: from localhost ([::1]:38362 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k0eGH-0004gB-GP for larch@yhetil.org; Wed, 29 Jul 2020 01:04:17 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37930) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k0eFg-0004fx-HR for emacs-orgmode@gnu.org; Wed, 29 Jul 2020 01:03:40 -0400 Received: from pb-smtp21.pobox.com ([173.228.157.53]:62594) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k0eFd-00068J-Vn for emacs-orgmode@gnu.org; Wed, 29 Jul 2020 01:03:39 -0400 Received: from pb-smtp21.pobox.com (unknown [127.0.0.1]) by pb-smtp21.pobox.com (Postfix) with ESMTP id 785FDED84E; Wed, 29 Jul 2020 01:03:34 -0400 (EDT) (envelope-from kyle@kyleam.com) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to:cc :subject:in-reply-to:references:date:message-id:mime-version :content-type:content-transfer-encoding; s=sasl; bh=lpXsNwK99lmy lo9gihh1jkNLZ/I=; b=ojT0BKbhhQIPBWJ/a8jh8zjSeSzJAncbJ65ZgT2KP/wm s8tRt3kX71e+7obZBcGyGqhyQVcvDvxs41YNHNBaDM/jkhLwuXhicuKpituQo6jc qBZQW8Q2fFrD5orvGFeLN/wjcSqdhqdq/2fh/s4tGTR/nG8vzGhNyKRjZjZUKNw= Received: from pb-smtp21.sea.icgroup.com (unknown [127.0.0.1]) by pb-smtp21.pobox.com (Postfix) with ESMTP id 7214AED84D; Wed, 29 Jul 2020 01:03:34 -0400 (EDT) (envelope-from kyle@kyleam.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=kyleam.com; h=from:to:cc:subject:in-reply-to:references:date:message-id:mime-version:content-type:content-transfer-encoding; s=mesmtp; bh=XpcibBxEO1EkMqQ6urG/6yNCZT26bkn0/KW164G0tvE=; b=mrYW3PlTSvxmUl/jLZvuCE8I16OdDkxV4ESoZU2o1KE8e33IQm934aK+G5od8HVKq1UEARtOyMcwe1VrxGO6CYpE7RxysvPMA2cpMR9M24Ly5yrDUXGubf4JP/SOIrXJi2GBtBQeLCDEIOq9Xui3IkdYWON3/R29DlUdG/ZAjY8= Received: from localhost (unknown [45.33.91.115]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pb-smtp21.pobox.com (Postfix) with ESMTPSA id E201EED84C; Wed, 29 Jul 2020 01:03:31 -0400 (EDT) (envelope-from kyle@kyleam.com) From: Kyle Meyer To: Matt Huszagh Subject: Re: incorrect documentation for file-desc header argument? In-Reply-To: <87lfj3c51a.fsf@gmail.com> References: <87lfj3c51a.fsf@gmail.com> Date: Wed, 29 Jul 2020 01:03:30 -0400 Message-ID: <87ime6ap5p.fsf@kyleam.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Pobox-Relay-ID: D930A95E-D158-11EA-95ED-843F439F7C89-24757444!pb-smtp21.pobox.com Received-SPF: pass client-ip=173.228.157.53; envelope-from=kyle@kyleam.com; helo=pb-smtp21.pobox.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/07/29 01:03:34 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.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, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=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: emacs-orgmode@gnu.org Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=pobox.com header.s=sasl header.b=ojT0BKbh; dkim=pass header.d=kyleam.com header.s=mesmtp header.b=mrYW3PlT; 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: -0.21 X-TUID: xb5wcihtz3ex Matt Huszagh writes: > The org info documentation states > > The =E2=80=98file-desc=E2=80=99 header argument defines the descript= ion (see *note > Link Format::) for the link. If =E2=80=98file-desc=E2=80=99 has no = value, Org uses > the generated file name for both the =E2=80=9Clink=E2=80=9D and =E2= =80=9Cdescription=E2=80=9D parts > of the link. > > However, if I evaluate the > > #+BEGIN_SRC asymptote :results value file :file circle.pdf :output-dir im= g/ > size(2cm); > draw(unitcircle); > #+END_SRC > > I get > > #+RESULTS: > [[file:img/circle.pdf]] > > I believe the documentation (and this is corroborated by the discussion > of the original patch > (https://lists.gnu.org/archive/html/emacs-orgmode/2012-04/msg00022.html)), > that the intended result is > > #+RESULTS: > [[file:img/circle.pdf][file:img/circle.pdf]] > > Is my assessment correct? Can anyone else confirm this bug? Yeah, that looks to be the intended result of that thread. That thread's patch was applied with a58a4f0ad (new source block header argument :filelinkdescr, 2012-03-27). However, shortly after, that treatment was intentionally changed (670c7f31c, 2012-03-31): simplified implementation of :file-desc header argument =20=20 This will no longer insert the value of the :file header argument as the description if the description is left blank (as this changes the meaning of the :file header argument). =20=20 The desc handling logic is moved to the `org-babel-result-to-file' function. So, I'd say this is a documentation bug.