From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id IPAID7Ly12LwcAAAbAwnHQ (envelope-from ) for ; Wed, 20 Jul 2022 14:18:58 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id sEggD7Ly12LXjAAA9RJhRA (envelope-from ) for ; Wed, 20 Jul 2022 14:18:58 +0200 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 D464A3EF3D for ; Wed, 20 Jul 2022 14:18:57 +0200 (CEST) Received: from localhost ([::1]:53686 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oE8fJ-00083l-2x for larch@yhetil.org; Wed, 20 Jul 2022 08:18:57 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46356) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oE8eF-00081Y-Ii for emacs-orgmode@gnu.org; Wed, 20 Jul 2022 08:17:55 -0400 Received: from mail-pl1-x629.google.com ([2607:f8b0:4864:20::629]:45709) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oE8eD-0003UB-Ki for emacs-orgmode@gnu.org; Wed, 20 Jul 2022 08:17:51 -0400 Received: by mail-pl1-x629.google.com with SMTP id w7so14798018ply.12 for ; Wed, 20 Jul 2022 05:17:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:subject:date:message-id:mime-version; bh=dDTGGd+bgamv2up2+bv5zIBBQgSUQcKhbC0hRZ64u/I=; b=Mvlel8HBHvdlGxCI02NkI6YdVyIcFaJPASKjMoDsOknJSGM20Im6MgLikub7/rvHdR Mht+xbEbvL4S+DrVryV3yIKmoqQbR3xsgdmgMEQ6HYGj1UeD3m4Zh9XO+AIxHzTkA3r6 TwimfEqQ4ppPCnhX9R9HL9AnTgS7eu9PKOen2kmz3vB28LRtezPE2hcTj2bOIvfz8Kaq CH7FHNnkvYv0gFlRIBOqssEpJ8J75SduWR/L4XawkUomGVM4hspY4Blr74yMDKUPt6Am AMNt2hIp/XzBQPU//HjVVhi8EMByL8XDaCHci3wyzcQzYw3sjVVXWmT6ANvVWwtf0c8I H2iA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:subject:date:message-id:mime-version; bh=dDTGGd+bgamv2up2+bv5zIBBQgSUQcKhbC0hRZ64u/I=; b=p8P73g8BaWtut2Iz8+nDNQJosUgBtkRNwgSvs2n/0La+q1NsC2JiEA72YATVH5vFNd l+tWo63L8Ixy6nzdUOXo2OVfdOxGjfFK1DCfybJu8I03hmXrw8idfXIsd9fAifT5Lesq GFsmCEDfHTPfapTDXkcdKh0MuoNjQakSGA5MjNz36EgNHSuj35f/cH1yRzwa1BtRIYyA NHgS3HkkSbKXcFIG1QaHaYsqgrMjHSvtqmzOPnNJvNiPO8blOjpcTDvISuXNcUjbir8J vG+TKHsNMNjg4qJT51ysdBsbOClihrn0BHQhFrKOBF94nwdH4ENUoHtlYnMTTos9cCo6 LPpQ== X-Gm-Message-State: AJIora/HjL4SL/r9o8ChcUgXuyPm39M2ie8+a+qQ0cTZs21Kor5wNau5 S9VMRlf+OSYcOB5sbw53XUJ/5LIHneI= X-Google-Smtp-Source: AGRyM1sJ1526G6BP4p2o/shwpYMl3ufQtFpspMeRMEwnAUpJvPpKgwOSBj8swvONIy4JtjQcy255Ww== X-Received: by 2002:a17:90b:3802:b0:1f0:5740:5880 with SMTP id mq2-20020a17090b380200b001f057405880mr4972382pjb.13.1658319467687; Wed, 20 Jul 2022 05:17:47 -0700 (PDT) Received: from localhost ([2409:8a70:2b7:3fb0:8ec6:81ff:fe70:339d]) by smtp.gmail.com with ESMTPSA id i2-20020a17090a65c200b001f219c5ae7dsm1483038pjs.31.2022.07.20.05.17.46 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 20 Jul 2022 05:17:47 -0700 (PDT) From: Ihor Radchenko To: emacs-orgmode@gnu.org Subject: [PATCH] org-manual: Document `org-babel-default-inline-header-args' Date: Wed, 20 Jul 2022 20:18:52 +0800 Message-ID: <87mtd42d03.fsf@localhost> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=2607:f8b0:4864:20::629; envelope-from=yantar92@gmail.com; helo=mail-pl1-x629.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 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, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1658319537; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=dDTGGd+bgamv2up2+bv5zIBBQgSUQcKhbC0hRZ64u/I=; b=V4tfPPq3OOJGGx3Tu3BIovTuo58nPIs7kE7tNf939YSvNVva4PIDHREwyhMxVFF+gNUnzc 7HStLdK/R9ETelCUZpCrr2Wde+8GoluDPUjD0kL7cnbFpye1gc+IV8vm46lTATXcptmH/7 YKrAHw7TpYYYz4a+oYpnWhluz+bos6Tk6oQFc3XZ71BVI1dXuDe03xM5L335X6wPcghFaN imxLRcrQYqucCQUTw304aQsWvr0eLajou9RkZ7i8QhH0ja1/HjtANFnDd3apXlYgu7ITKg 0y/Qqw6YH0uVA+tvaWOETF2EUueygWs4AIny4dvnEK5nD+EJxune7GsuR50AeQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1658319537; a=rsa-sha256; cv=none; b=jW0iSlCfV7QASKFQPZStdz/qBqKMWFcOJcyb0d8f/5DPecO1ghML6s7WeanVPyolFRlUiY 8oEJtYgXHBTZptdY1MpqOhIOMTXNtDAnQw4fpMhCEhjU/Ec5SmrT6k+D9OF7hu1N7AHWsK 6PvDIFCJbQ6zgRq3bkEWhDIFAbzQ52HmUvJ+qP/4V+pKcJEDa9QTZ4W0zpa5D3MvB1MKk0 daMB9/TjZ5XIQtd2YnsJEIPvxj4RauSDxmJg/np1hWXVEUP88IhT9NfgHV00QtkdkUgPHd FyQoJLm1p+rJx1ABVn/a/nKKNToXUN/8ayWn5AvQPfGe8ZUTOqmXUNB3GI8L4w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Mvlel8HB; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -6.94 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Mvlel8HB; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: D464A3EF3D X-Spam-Score: -6.94 X-Migadu-Scanner: scn0.migadu.com X-TUID: WyY3XpZI0jiz --=-=-= Content-Type: text/plain Hi, In https://orgmode.org/list/87ee927emf.fsf@localhost I proposed to document org-babel-default-inline-header-args in the manual. Here is the patch. WDYT? Also, I noticed that org-babel-default-header-args has :hlines "no" while org-babel-default-inline-header-args has :hlines "yes" The "yes" value can cause errors as documented in the manual (16.6 Results of Evaluation). I am not sure if it is a good default. Also, the commit introducing the change does not provide any details on why it was there to start with: c67e3cda1 default to preserving hlines in call lines * lisp/ob-core.el (org-babel-default-inline-header-args): Added (:hlines "yes") to the default value. Does anyone know any reason why "yes" value should be kept for inline src blocks in contrast with "no" for normal src blocks? I'd be better if we can explain this in the manual. Best, Ihor --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-org-manual-Document-org-babel-default-inline-header-.patch >From 51b10e5ca5bb368e71655466a4be5267e6e99d0f Mon Sep 17 00:00:00 2001 Message-Id: <51b10e5ca5bb368e71655466a4be5267e6e99d0f.1658319102.git.yantar92@gmail.com> From: Ihor Radchenko Date: Wed, 20 Jul 2022 20:03:37 +0800 Subject: [PATCH] org-manual: Document `org-babel-default-inline-header-args' * doc/org-manual.org (System-wide header arguments): Update the default value of `org-babel-default-header-args'. Document that inline source blocks use a different set of the default arguments. --- doc/org-manual.org | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/org-manual.org b/doc/org-manual.org index 26d18f533..7823fbd74 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -17015,8 +17015,31 @@ *** System-wide header arguments :exports => "code" :cache => "no" :noweb => "no" +:hlines => "no" +:tangle => "no" #+end_example +#+vindex: org-babel-default-inline-header-args +Inline source blocks (see [[*Structure of Code Blocks]]) use slightly +different default header arguments defined in +~org-babel-default-inline-header-args~: + +#+begin_example +:session => "none" +:results => "replace" +:exports => "results" +:hlines => "yes" +#+end_example + +The most notable difference between default header arguments for +inline and normal source blocks is =:exports= argument. For inline +source blocks, results of evaluation are exported by default; not the +code. + +Unlike the default values, header arguments set using Org mode +properties (see [[*Header arguments in Org mode properties]]) do apply to +both the normal source blocks and inline source blocks. + The example below sets =:noweb= header arguments to =yes=, which makes Org expand =:noweb= references by default. -- 2.35.1 --=-=-=--