From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id 0EL/AUcgIl8TEgAA0tVLHw (envelope-from ) for ; Thu, 30 Jul 2020 01:20:07 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id oJ+GOUYgIl8ACAAA1q6Kng (envelope-from ) for ; Thu, 30 Jul 2020 01:20:06 +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 697239403AE for ; Thu, 30 Jul 2020 01:20:06 +0000 (UTC) Received: from localhost ([::1]:44728 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k0xEq-0007Bx-T1 for larch@yhetil.org; Wed, 29 Jul 2020 21:20:04 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:34734) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k0xEU-0007Bc-Lw for emacs-orgmode@gnu.org; Wed, 29 Jul 2020 21:19:42 -0400 Received: from mail-pf1-x433.google.com ([2607:f8b0:4864:20::433]:39498) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1k0xES-0000Vt-VT for emacs-orgmode@gnu.org; Wed, 29 Jul 2020 21:19:42 -0400 Received: by mail-pf1-x433.google.com with SMTP id z188so6241101pfc.6 for ; Wed, 29 Jul 2020 18:19:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version; bh=7T/y1/CyAwUu4Wmg9KobfTL+O3L8Jp8OLVe8FF/E4X4=; b=kBY61tnurxwPzltLc9Q5pLiW8IYHD4dIQJaLoG5XddvLO/2aSHm+FPGCI1clUDPXHQ +xW/pTlczn9+5KBo/q2ZuWCaiDp5/eYsr2AAtOOj283xC8Yf7YQ3/Lg6QiR7TXPxXPYU b73D8LANxGTx5MYmZty/zssUCcA0KJ0+hKss2MLxUqqkBzrIKb1gbX2HvllgzcP8CvIi KinN42ukMkvZb8pSdJpgPt50INHueA4IQKArGMOIdF32zUDxZ/43rHE2G2/GyPdmC5BU gHucW0QbWe7uYtEEiQk1URqLhQwMNQd/VBUqrLTNRvn0HU1r6YSBwSY0ZSgaKzxrDWDD 5lAA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version; bh=7T/y1/CyAwUu4Wmg9KobfTL+O3L8Jp8OLVe8FF/E4X4=; b=JA86bEhx3r+jvG/QXnOE66Q+diNDb2gA59zBXhgWayCqxOpPirMIhZluY3IayiXlaZ kyCB2K166XDxg5IdL9ijYwnzaWeqfdj4GvveSkIyYTkcy9ynG91jsU5V845oLQrJpYUy ++x4ri5d1t0d8aYkhNYa1ZpTT3EnohQ8T2pQtgtngsfb1hxSr99jqAq0ui+xWXj3TH03 QpykkwTGwVyN95qchDKUiqy/LHTthIMYf3PgoUn/rPWEVf/U+61zMlvos/mu2rYsxJck i+lO/sh5ty1ZhUEPeTEssnNIYhw3N9U7wfxMIW22CAK3GfQtcw6H2T7UDLrWXH0Z/3ek PzlQ== X-Gm-Message-State: AOAM5307C1c3zKysPymL9gc0/xCB3C2JzvBEcrpOVR2V6D8V0p6uN0DN IdeG+B3M7Fj4JG5T0eMW8kcePNM2 X-Google-Smtp-Source: ABdhPJzWFHHPaO7bMyg8v1K6NRGDencFOfPjej+yPjSZ6kLOVCMqmAP+0CunCSj2gDfc7ibsnRqkBQ== X-Received: by 2002:a63:210c:: with SMTP id h12mr31419611pgh.152.1596071977758; Wed, 29 Jul 2020 18:19:37 -0700 (PDT) Received: from ryzen3950 (c-73-71-89-135.hsd1.ca.comcast.net. [73.71.89.135]) by smtp.gmail.com with ESMTPSA id j7sm594387pfr.138.2020.07.29.18.19.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Jul 2020 18:19:36 -0700 (PDT) From: Matt Huszagh To: Kyle Meyer Subject: Re: incorrect documentation for file-desc header argument? In-Reply-To: <87ime6ap5p.fsf@kyleam.com> References: <87lfj3c51a.fsf@gmail.com> <87ime6ap5p.fsf@kyleam.com> Date: Wed, 29 Jul 2020 18:19:35 -0700 Message-ID: <87d04ddck8.fsf@gmail.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=2607:f8b0:4864:20::433; envelope-from=huszaghmatt@gmail.com; helo=mail-pf1-x433.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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=gmail.com header.s=20161025 header.b=kBY61tnu; 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-Spam-Score: -0.71 X-TUID: nN5zzJOhspmI --=-=-= Content-Type: text/plain Kyle Meyer writes: > 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 > > 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). > > The desc handling logic is moved to the `org-babel-result-to-file' > function. > > So, I'd say this is a documentation bug. Thanks for the clarification Kyle. I've attached a patch that I believe clarifies the documentation to match the current behavior. Matt --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-org-manual.org-Modify-file-desc-header-argument-to-m.patch >From a9cd13f3d7b120a24b3416f8f8ba0892a8e47221 Mon Sep 17 00:00:00 2001 From: Matt Huszagh Date: Tue, 28 Jul 2020 22:10:12 -0700 Subject: [PATCH] org-manual.org: Modify file-desc header argument to match action --- doc/org-manual.org | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index b61644626..0f012d4df 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -17436,9 +17436,8 @@ default behavior is to automatically determine the result type. #+cindex: @samp{file-desc}, header argument The =file-desc= header argument defines the description (see - [[*Link Format]]) for the link. If =file-desc= has no value, Org - uses the generated file name for both the "link" and - "description" parts of the link. + [[*Link Format]]) for the link. If =file-desc= has no value, the + "description" part of the link will be omitted. #+cindex: @samp{sep}, header argument By default, Org assumes that a table written to a file has -- 2.27.0 --=-=-=--