Re: [PATCH] Add repeat-map for navigation commands

[Ihor Radchenko <yantar92@posteo.net>]

Visuwesh <visuweshm@gmail.com> 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'.

> +** 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
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.

> +*** 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.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>