Visuwesh <[email protected]> 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>
