From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id OMY2OYcV8GYF4AAA62LTzQ:P1 (envelope-from ) for ; Sun, 22 Sep 2024 13:03:04 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id OMY2OYcV8GYF4AAA62LTzQ (envelope-from ) for ; Sun, 22 Sep 2024 15:03:04 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=IS+SlY2N; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1727010183; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=Lbr2eZOPJIeV7mhVvAuHgC8ZrYw7i1FAQ07sSGlNo4s=; b=tR1c4D2EuORVH7cSXp6b+Q7RbN9Lm8Ed/TzuTNFa6c2EWRuTPcyM3vCNivFa0mqmAXSRfL dc8HU8PIc1UNKnX2drRmt2bGqRjz2medfWL0mhAq2QnCDcoZtIPRJ1qOBBfcWZ+rZuvjts CAcJw0IzWpflczslHRUE6YTLC5vg+Q8pjBkoXPG203P1bfVekhkyWyJweh6GCFGblEZkdG BEQlIBAVIJNDsb6JhzcD6sRx0lhCtwexqaSsG84+QGb0IhRbWGeAKD+LlJgMkzpczwQP0q C2ePG1eOxLphqFyF4Nnr2auPTpBIlfoACdLXYdw85peD2rFDeLe9HtOHAbW5oQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1727010183; a=rsa-sha256; cv=none; b=CT7ilyJBFuwKEfRRD6Z9ZOJ9XPft9pmKDon9/KYcL4UlbxNJ/45FdKpQSe1oEdsz2j4tOV GKSyDUaTo0R2pT37z163Iz2XFytuItPVzxCv+cnrV1Bytwb+4BjLFTilPxz5VSH8IawRML JTcYfRwJjK/mp4ekL1MHiEKO4oj1Rfm+8Cd99R/T8mnZuAQgWvVhW7tV3B6a/Os4uhvYUC jsZchI5b+aacFpinCP7LHj1FocTpulA1J5OQwWOdLfbzXuOGTngAEmYR4R7o1CY3X/R9Zq LxFmc3MNMsLSQqy0M2yQttmQjQJdIIV/qFXDs+mGc8qToA37G3FVTIGCn0nhyw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=IS+SlY2N; 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" 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 CEB97589DD for ; Sun, 22 Sep 2024 15:03:03 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ssMED-0006Nq-Rq; Sun, 22 Sep 2024 09:02:18 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ssMEA-0006NK-5d for emacs-orgmode@gnu.org; Sun, 22 Sep 2024 09:02:14 -0400 Received: from mail-pf1-x442.google.com ([2607:f8b0:4864:20::442]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ssME8-00014i-I1 for emacs-orgmode@gnu.org; Sun, 22 Sep 2024 09:02:13 -0400 Received: by mail-pf1-x442.google.com with SMTP id d2e1a72fcca58-7198a7a1c01so3125778b3a.1 for ; Sun, 22 Sep 2024 06:02:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1727010131; x=1727614931; darn=gnu.org; h=content-transfer-encoding:mime-version:user-agent:references :message-id:date:in-reply-to:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to; bh=Lbr2eZOPJIeV7mhVvAuHgC8ZrYw7i1FAQ07sSGlNo4s=; b=IS+SlY2NfWGsDbwNzmmANlE4FRW4OobVGLjzAi0Xh5822MLb8MtlFwYNH1DM60NYvk lLayG2vjlyVmnwqbwlkcnmvln+PJe/5ECbkaAHzuEHN+gE3M15t8LGyFnynNzyEbiuPf j+ORazhuJaOD3Tu2VzDSnTzjDsJJrSgaCJjgCMvG0t77p33PkR9G5aAHXdBTmoPldc0T rbFofZKwO66x9Ylh5f3mo+XrZlBMis5dTQYTmgfzt7SImKDgv4+CUMbtgdDjP4jKVQyQ agYPgd+P3diH3ETCNo/ZAVi23fb//rMqQBJA+OXoNCNUgu1I+3EzeyyP5OD9sbPKS9YZ jvrQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1727010131; x=1727614931; h=content-transfer-encoding:mime-version:user-agent:references :message-id:date:in-reply-to:subject:cc:to:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=Lbr2eZOPJIeV7mhVvAuHgC8ZrYw7i1FAQ07sSGlNo4s=; b=HpXoXL+9NqyO7ChcF9yJcl0VoDGr4uwUrTOJTOtTc0qdK65yY5zbYk3TAm///h7oKu bBvqMF184ZZw/FcqacJhCxg/TKFBfV2mdpQLWAUsnNNZaZBkMxh7BhnsDaovk1AwikCc IEIrUyhzyUyTgpbrcJf1JYDnlAzq+WLJkd+5o8N1rirvIXax7ycKvSP5ztHc6rWYnv1V J29S5Axb8u+W4Yd6GF6Z6AkUiYq6d4MaM86kpUUwO/gfudWdt0U8/7TAIOC2DlflCU0l tc055GVurzENrPX9NQfhkeBFYH5zRtuzdqpxMqdok+MnruL4zVftnyalOi7zLdLa0NQs wIZg== X-Gm-Message-State: AOJu0YwwFdqA21ciIy5R81pvvKLnDvUKMhcV31Hccg11jP0cbZwz54tg +pKWHsyxfLs25t5aJeqfZYAUBdpqwMuA0tQp/+lsMPtG2kDDPYZl X-Google-Smtp-Source: AGHT+IEGFsqmKdBE8utPfxs50OnNH/eC8Q5tdiHCR6+PRnhkybaiXnzjdjq9KjARsQqbI9zEMqkVSA== X-Received: by 2002:a05:6a20:1e52:b0:1d3:dc2:4496 with SMTP id adf61e73a8af0-1d30dc260b4mr8709225637.2.1727010130626; Sun, 22 Sep 2024 06:02:10 -0700 (PDT) Received: from localhost ([1.7.159.70]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-71944a9707dsm12458264b3a.38.2024.09.22.06.02.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 22 Sep 2024 06:02:10 -0700 (PDT) From: Visuwesh To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: [PATCH] Add repeat-map for navigation commands In-Reply-To: <87frprrjso.fsf@localhost> (Ihor Radchenko's message of "Sun, 22 Sep 2024 11:48:23 +0000") Date: Sun, 22 Sep 2024 18:28:16 +0530 Message-ID: <87v7ynetg7.fsf@gmail.com> References: <877cbkoqkt.fsf@gmail.com> <8734m8rcoh.fsf@localhost> <87wmjk6qk8.fsf@gmail.com> <87cyl53vzx.fsf@localhost> <87r09jwzlm.fsf@gmail.com> <87frprrjso.fsf@localhost> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::442; envelope-from=visuweshm@gmail.com; helo=mail-pf1-x442.google.com 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 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Spam-Score: -5.61 X-Spam-Score: -5.61 X-Migadu-Scanner: mx13.migadu.com X-Migadu-Queue-Id: CEB97589DD X-TUID: m7f021yqd8p4 [=E0=AE=9E=E0=AE=BE=E0=AE=AF=E0=AE=BF=E0=AE=B1=E0=AF=81 =E0=AE=9A=E0=AF=86= =E0=AE=AA=E0=AF=8D=E0=AE=9F=E0=AE=AE=E0=AF=8D=E0=AE=AA=E0=AE=B0=E0=AF=8D 22= , 2024] Ihor Radchenko wrote: > Visuwesh writes: > >> Please find attached. I tried my best to write the manual entry but it >> still reads awkward. > > Thanks! > >> * lisp/org-keys.el (org-up-heading): Add new alias for >> outline-up-heading. > > Please quote Elisp symbols as `outline-up-heading'. Oops, will fix. >> +** Repeating commands >> +:PROPERTIES: >> +:DESCRIPTION: Repeating navigation commands >> +:END: >> + >> +#+cindex: repeat-mode, org-mode >> +#+cindex: repeating navigation commands >> +When ~repeat-mode~ is turned on, headline motion commands, link and >> +block navigation commands by only pressing a single key. For example, >> +when navigation to the next headline using {{{kbd(C-c C-n)}}}, a >> +repeat map is activated that lets you quickly execute headline motion >> +commands. When a key not in the map is pressed, it exits ~repeat-mode~ >> +and the command corresponding to the key is executed. > > 1. You can link to "9.11 Repeating a Command" section of Emacs manual Can you please tell how to link to an Info node? I see two different style of linking to another manual in Introduction/Activation and I'm confused. I do not know how ox-texinfo works. > 2. I think that it is a good idea to provide a more clear example. > Something like: "Instead of pressing C-c C-n repeatedly, you can > omit C-c and just use C-c C-n n n p u... to move around." > 3. We need to clarify which bindings are default (n, p, u, f, > b). Probably as a table. OK, will do this as well. >> +*** Some navigation commands can now be repeated >> + >> +When ~repeat-mode~ is turned on, certain navigation can be repeated. >> +These include the headline navigation commands, ~org-next-link~ and >> +~org-previous-link~, and ~org-next-block~ and ~org-previous-block~. > > Example and a link to Emacs manual would also be good here. > And we probably need to mention `org-navigation-repeat-map' to let users > know what to customize if they prefer alternative bindings. Thanks, will do this in a future patch. Hopefully, by this week.