From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id 0Nf5K89/W2RLZAAASxT56A (envelope-from ) for ; Wed, 10 May 2023 13:28:15 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id 0Ln+K89/W2QWNgEA9RJhRA (envelope-from ) for ; Wed, 10 May 2023 13:28:15 +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 602092D961 for ; Wed, 10 May 2023 13:28:15 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pwhyk-0004Pp-VX; Wed, 10 May 2023 07:27:30 -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 1pwhyj-0004Ph-15 for emacs-orgmode@gnu.org; Wed, 10 May 2023 07:27:29 -0400 Received: from mout01.posteo.de ([185.67.36.65]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pwhyg-0004Re-HW for emacs-orgmode@gnu.org; Wed, 10 May 2023 07:27:28 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id A2C6E2406F8 for ; Wed, 10 May 2023 13:27:24 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1683718044; bh=nNXIpTKByM7OJ8nHt3zN4V7q03FFDwt6hwF/qkAhUs4=; h=From:To:Cc:Subject:Date:From; b=I9UmzceL81h/CYUTnygiA+xDK8BSePovNajd8Zn6UkJ7QmhVxXQlkQi3FrjvE8g5r j/APe/3nVE0PzFmeTYkFgzxnxGFnxsP3y7OSgqwBUkhpXGWSeJaQmNDhbxglm6MmxG xnFzf+b7a84RonGlRsbNmWBEwtHdfdcJ328ghUNj7V9rZWfS2YwppWTlVzK+1+G4zZ thrS+J/IFtLIEqSzhtLmvUnV2o6Q35bcK1pdc6MqBLqYV6pmab6zCu8FfEQCenehdS 98KdP5YK0KMgq4pRZuJNOka1ejRzIQCAYxQVuoB9eifkGkai0O4e9+mQscRp6u26gf +X10g/G8Ch7AQ== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4QGXn81n68z9rxQ; Wed, 10 May 2023 13:27:24 +0200 (CEST) From: Ihor Radchenko To: Yuval Langer Cc: emacs-orgmode@gnu.org Subject: Re: Suggestion: for each listed keybinding, also name the command In-Reply-To: References: Date: Wed, 10 May 2023 11:30:42 +0000 Message-ID: <87v8h0a0f1.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net; helo=mout01.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Seal: i=1; s=key1; d=yhetil.org; t=1683718095; a=rsa-sha256; cv=none; b=jfIWf+aqDdUjrf/WGrc3ve2Nb01O0VIGMnWm6EWrv+d8cXVo+zCQBYsYGnch2pMoMOgRjH dzD8j/5X0TzIE7nKwcXvsb3Y7djSy3Y+4vyHEUOdtzXKnZMwAvJN5NdToaUrMagd2/CfMd pjlafAdT9mWIpGVxj8YMA30ee3SnDXinNBmlCybUg7GrhyvCsBGkVOAXSmMbA2J5K60yGx CQyQQLsEqUmLt9TE09JEALX4iuZirWlR03n+kJBF/GeyxIbNtP3Hm3G+iHB0w3WOpUfZDg 0oIrwWBZxYRDsgt9YOBcIB8fZOzF6tyQ4zjgH2dOv/ICOwLrgohk0jGiwS5T8Q== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=I9UmzceL; dmarc=pass (policy=none) header.from=posteo.net; 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=1683718095; 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=2jWO3TpHssdBINszG3I9QGzMfP8f3mZLkeLRzelxoQ8=; b=Ksn9tzH2d23rybgc2Os2gXvCRpUxV7V1pmkM7vi0Nj5sDZdQ08LzlksuMmIhiqFh8e7+iD fo6yRvwrIhnQ9bksebIRDeqGYHBuf3o57K4Jdh2RnueEnZGUHlAWz4YZa+nWS6HoZheX6f 6549uZTgfetMKCNj+WZRw55Owfa6kkRrXWIfG0Nc0UTFbh49Yn0fbJCUFKVM654+GXAWLN JIFlYNAqfBPW3QUY4H+3ULci+rgf2BR0O7uEt6l9KryqyJB9/x30g0Pk1l/PJqZ8jKItJx wZO+fivXm7dmJq1FgB1no3bi/yHQmfzq7ibRr4X3G6CEky+hkJpXZrq+D0vKAQ== X-Migadu-Spam-Score: -4.58 X-Spam-Score: -4.58 X-Migadu-Queue-Id: 602092D961 X-Migadu-Scanner: scn0.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=I9UmzceL; dmarc=pass (policy=none) header.from=posteo.net; 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-TUID: ZlCBjt+m9Osx Yuval Langer writes: > I have: > > - Added all the obvious commands to the `- {{{kbd(=E2=80=A6)}}} ::` lines. Thanks, but after your patch the manual does not compile. Did you try to generate the guide via "make docs" after the patch? > - Left several of these lines without a command where I've the manual > do the same. May you please list these? > -- {{{kbd(S-TAB)}}}, {{{kbd(C-u TAB)}}} :: > +- {{{kbd(S-TAB)}}} (~org-global-cycle~), {{{kbd(C-u TAB)}}} :: Why nothing for C-u TAB? > -- {{{kbd(C-c C-l)}}} (with point on existing link) :: > +- {{{kbd(C-c C-l)}}} (with point on existing link) (~org-insert-link~) :: This is inconsistent with other similar cases, where the key binding is followed by some text. You added command name right after the key binding, not after the text. =20=20 > -- {{{kbd(C-c C-c)}}} :: > +- {{{kbd(C-c C-c)}}} (~org-toggle-checkbox~), {{{kbd(C-u C-c C-c)}}} :: Why nothing for C-u ... ? =20=20 > -- {{{kbd(C-c / m)}}} or {{{kbd(C-c \)}}} :: > +- {{{kbd(C-c / m)}}} or {{{kbd(C-c \)}}} (~org-match-sparse-tree~) :: What about C-c / ? =20=20 > #+attr_texinfo: :sep or > -- {{{kbd(C-c [)}}} :: > +- {{{kbd(C-c [)}}} (~org-agenda-file-to-front~) :: Please, pay attention to :sep list attribute (see 13.14.9 Plain lists in Tex info export). You need to change it here because "or" separator no longer works as the command name contains "..or..". This change makes the compilation fail. Basically, you need to change the separator to, say, ";" and alter the following list items accordingly.=20 > Add current file to the list of agenda files. The file is added to > the front of the list. If it was already in the list, it is moved > to the front. With a prefix argument, file is added/moved to the > end. >=20=20 > -- {{{kbd(C-c ])}}} :: > +- {{{kbd(C-c ])}}} (~org-remove-file~) :: Same here. =20=20 > -- {{{kbd(r)}}}, {{{kbd(g)}}} :: > +- {{{kbd(r)}}} (~org-agenda-redo~), {{{kbd(g)}}} :: Why nothing for "g"? > #+attr_texinfo: :sep , > -- {{{kbd(C-c C-e t a)}}}, {{{kbd(C-c C-e t u)}}} :: > +- {{{kbd(C-c C-e t a)}}} (~org-ascii-export-to-ascii~), {{{kbd(C-c C-e t= u)}}} :: What about C-c C-e t u? --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at