From mboxrd@z Thu Jan 1 00:00:00 1970 From: Sebastian Miele Subject: [PATCH] org-manual: Dynamic Blocks: Fix explanation of :content Date: Mon, 14 Oct 2019 23:29:30 +0000 Message-ID: <87ftjulxd1.fsf@gmail.com> Reply-To: sebastian.miele@gmail.com Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:47865) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iK9mR-0002du-3g for emacs-orgmode@gnu.org; Mon, 14 Oct 2019 19:29:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iK9mQ-0003Cy-4l for emacs-orgmode@gnu.org; Mon, 14 Oct 2019 19:29:35 -0400 Received: from mail-wr1-x443.google.com ([2a00:1450:4864:20::443]:33597) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iK9mP-0003Bx-Sz for emacs-orgmode@gnu.org; Mon, 14 Oct 2019 19:29:34 -0400 Received: by mail-wr1-x443.google.com with SMTP id b9so21547019wrs.0 for ; Mon, 14 Oct 2019 16:29:33 -0700 (PDT) Received: from tisch ([2a02:908:175c:4260:5ffc:7882:6024:ca5b]) by smtp.gmail.com with ESMTPSA id q124sm39909173wma.5.2019.10.14.16.29.31 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 14 Oct 2019 16:29:31 -0700 (PDT) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org * doc/org-manual.org (Dynamic Blocks): Correct the information given on :content in the plist passed to the writer function. --- doc/org-manual.org | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 59591894d..79257b7e0 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -20089,13 +20089,12 @@ These commands update dynamic blocks: Before updating a dynamic block, Org removes content between the =BEGIN= and =END= markers. Org then reads the parameters on the -=BEGIN= line for passing to the writer function. If the function -expects to access the removed content, then Org expects an extra -parameter, =:content=, on the =BEGIN= line. +=BEGIN= line for passing to the writer function as a plist. The +previous content of the dynamic block becomes erased from the buffer +and appended to the plist under ~:content~. The syntax for naming a writer function with a dynamic block labelled -=myblock= is: ~org-dblock-write:myblock~. Parameters come from the -=BEGIN= line. +=myblock= is: ~org-dblock-write:myblock~. The following is an example of a dynamic block and a block writer function that updates the time when the function was last run: -- 2.23.0