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 ms0.migadu.com with LMTPS id aKsgFxJHFGHfswAAgWs5BA (envelope-from ) for ; Wed, 11 Aug 2021 23:54:26 +0200 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 SCHFEhJHFGHQMgAA1q6Kng (envelope-from ) for ; Wed, 11 Aug 2021 21:54:26 +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 80B2D187C8 for ; Wed, 11 Aug 2021 23:54:25 +0200 (CEST) Received: from localhost ([::1]:56666 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mDwB6-0006vi-Lb for larch@yhetil.org; Wed, 11 Aug 2021 17:54:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:52738) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDwAj-0006vL-Lv for emacs-orgmode@gnu.org; Wed, 11 Aug 2021 17:54:01 -0400 Received: from knopi.disroot.org ([178.21.23.139]:53606) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mDwAe-00057Z-Qr for emacs-orgmode@gnu.org; Wed, 11 Aug 2021 17:54:01 -0400 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 83CF554772 for ; Wed, 11 Aug 2021 23:53:54 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id HyWueAzCn6Pp for ; Wed, 11 Aug 2021 23:53:53 +0200 (CEST) From: Jorge P. de Morais Neto DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1628718833; bh=erHCZ21u9sweWJUqnUpUR0FrqRhn7Ul6YrMB3KcdVvc=; h=From:To:Subject:In-Reply-To:References:Date; b=Ohvh2Srp8OrKzBgQVzXp4pq71eReU8fU9mlVO/rxqxB2/J4U6zrpAq40y+iTX3dRO lIc6CuadWcyjGhd2d4C2ObLNpPR2QGovdF4KleA1IsXvn76XJYh+PZ1MAIiJGMpgLT AWJeJFArMbWLQ9zAP5phe5ks6prBFD7GqAtfzlVyjBMGPz89ztfLvR9YocFUZZvNAP bBk/KZ9tmpw8/bS3Z5Soemc5a0+wpOrF9Z6uvYWCSusfcklYSoHRD+pX7ZGSXeKbNA VRrveVFxE6CDL8XL7VQCdB4yUaMsTV0GaHXCL9AhH4viw6gxIdjeNlnvC0x/j+0XsU 42/W5KjU8Xp+w== To: emacs-orgmode@gnu.org Subject: Re: Bug: Small documentation errors [9.3.6 (9.3.6-29-g6a3dff-elpaplus @ /home/jorge/.emacs.d/elpa/27.0/develop/org-plus-contrib-20200406/)] In-Reply-To: <8735rfbt9f.fsf@nicolasgoaziou.fr> References: <87a73gstpz.fsf@disroot.org> <87v94bsoml.fsf@disroot.org> <8735rfbt9f.fsf@nicolasgoaziou.fr> Mail-Followup-To: emacs-orgmode@gnu.org Date: Wed, 11 Aug 2021 18:53:48 -0300 Message-ID: <87sfzfsl5f.fsf@disroot.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=178.21.23.139; envelope-from=jorge+list@disroot.org; helo=knopi.disroot.org 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, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-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: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1628718865; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=96PIPvmtAKE22KDLofz+bi8XLbYYNvbOftkwj+YIG/I=; b=T6+cSnrjVdq0thstcVhn8nEb2iRCJddOepqikjMmsYPlrhTW6CObZNKsAN5oUkI2FWdjx2 vO5xNrvE8lLOimVGKYEpvQSzh9Fq/dbZcMWzN1CAa0EXlMSJzvampIi3rpz/+wqIpLzO3P IpR19iegW0YWvZ1l24a7WGHOIo1Ko4SllEUEIKFXJCKqnKks0AI7ITnb/g9dFhi0S9VimD WblPFbrahkSEBkxmRZUKI+jfwgmA+kxMC16IcBBECeXSs00rlQE8zkVzyBP/WBigphjMnQ Ed3w6k2wQwkiAQG/VwFB1QI703/JZgfTLzddXQ6XZHRA0UlsIXxC+pqH1c/Kvw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1628718865; a=rsa-sha256; cv=none; b=pWTvqdgw1FMf9WRTZzWI5IhxJGE9vAuRl2ExPaElCbdCzbbLnL1Z74HnYMGmdQc/SB6eGt VLOj8eI4BRFP9Go3NFcBrKmesLvn3oCBmPfTO77UVSmRMXWEXdwqqfKGBJqfrzX5qQ79XF KCbaWrQ7KScT0Lki+hfN4gx4So2pPM/W0mKcT4KYPOiAO05oUORoZ4uxjovuuSvH6W8MVz 4/033qacQEfxazUyDRuXjOAmFHQRS5bCnomSajG3k9A+f050aQT+5SD5DCNSgvluHfk6lV UTA2qDGP1kgAfeDmeiG+jbLXpFe2uI8ua0Q9kVAkkyob6Z9kzo5mVOeUUy/TvQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=Ohvh2Srp; dmarc=pass (policy=quarantine) header.from=disroot.org; 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-Migadu-Spam-Score: -2.61 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=disroot.org header.s=mail header.b=Ohvh2Srp; dmarc=pass (policy=quarantine) header.from=disroot.org; 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-Migadu-Queue-Id: 80B2D187C8 X-Spam-Score: -2.61 X-Migadu-Scanner: scn1.migadu.com X-TUID: JECsbqcz2hCM --=-=-= Content-Type: text/x-diff; charset=utf-8 Content-Disposition: attachment; filename=0001-doc-org-manual.org-Drawers-Clarify-M-TAB.patch Content-Transfer-Encoding: quoted-printable >From d3c62edf7a713278432ebe1c72e4545b8a2b84e2 Mon Sep 17 00:00:00 2001 From: "Jorge P. de Morais Neto" Date: Wed, 11 Aug 2021 18:43:21 -0300 Subject: [PATCH] * doc/org-manual.org (Drawers): Clarify M-TAB Provide example of completion over drawer keywords. Also clarify the footnote by qualifying "windows" as "graphical". --- doc/org-manual.org | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index d34d33561..467644453 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -1214,7 +1214,22 @@ Org mode uses this special drawer for storing proper= ties (see [[*Properties and Columns]]). You cannot use it for anything else. =20 Completion over drawer keywords is also possible using -{{{kbd(M-TAB)}}}[fn:16]. +{{{kbd(M-TAB)}}}[fn:16]. For example, if the buffer contains + +#+begin_example +:foo: +:end: + +:f=E2=98=85 +#+end_example + +#+texinfo: @noindent +(where =E2=98=85 indicates the location of point) then {{{kbd(M-TAB)}}} wi= ll +complete the line as + +#+begin_example +:foo:=E2=98=85 +#+end_example =20 Visibility cycling (see [[*Visibility Cycling]]) on the headline hides and shows the entry, but keep the drawer collapsed to a single line. In @@ -21500,8 +21515,8 @@ variable ~org-M-RET-may-split-line~. =20 [fn:15] See ~org-list-use-circular-motion~ for a cyclic behavior. =20 -[fn:16] Many desktops intercept {{{kbd(M-TAB)}}} to switch windows. -Use {{{kbd(C-M-i)}}} or {{{kbd(ESC TAB)}}} instead. +[fn:16] Many desktops intercept {{{kbd(M-TAB)}}} to switch graphical +windows. Use {{{kbd(C-M-i)}}} or {{{kbd(ESC TAB)}}} instead. =20 [fn:17] To insert a vertical bar into a table field, use =3D\vert=3D or, inside a word =3Dabc\vert{}def=3D. --=20 2.32.0 --=-=-= Content-Type: text/plain Hello, Em [2021-08-11 qua 22:50:36+0200], Nicolas Goaziou escreveu: >> Sorry for insisting, but can someone give me an example of what the >> manual means by "Completion over drawer keywords"? > > :foo: > :end: > > :f| > > With point at |, M-TAB will complete the line as > > :foo: Then how about the attached patch? Note that I used a black star to indicate the position of point---the convention in the Elisp manual. Also, I provided a ~+#+texinfo: @noindent~ directive so the continuation would not be indented, because it is not a new paragraph. Please tell whether that made sense---I know little about Texinfo and typography. Also tell whether I am making good use of time---mine and yours. I have OCD and I often nitpick about details of little relevance; feedback about that is always welcome. Regards -- - Disinformation flourishes because many people care about injustice but very few check the facts. Ask me about - I am Brazilian. I hope my English is correct and I welcome feedback. - Free Software Supporter: https://www.fsf.org/free-software-supporter - If an email of mine arrives at your spam box, please notify me. --=-=-=--