[PATCH] doc: Document C-. for jumping to today when choosing a timestamp

[PATCH] doc: Document C-. for jumping to today when choosing a timestamp

[Adam Spiers]

This useful key binding was previously missing from the manual.

Signed-off-by: Adam Spiers <orgmode@adamspiers.org>
---
 doc/org-manual.org | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 3eb745b5d..7c291c3a7 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -6028,6 +6028,7 @@ calendar, or by pressing {{{kbd(RET)}}}, the date selected in the
 calendar is combined with the information entered at the prompt.  You
 can control the calendar fully from the minibuffer:
 
+#+kindex: C-.
 #+kindex: <
 #+kindex: >
 #+kindex: M-v
@@ -6041,6 +6042,7 @@ can control the calendar fully from the minibuffer:
 #+kindex: M-S-LEFT
 #+kindex: RET
 #+attr_texinfo: :columns 0.25 0.55
+| {{{kbd(C-.)}}}       | Jump to today.                         |
 | {{{kbd(RET)}}}       | Choose date at point in calendar.      |
 | {{{kbd(mouse-1)}}}   | Select date by clicking on it.         |
 | {{{kbd(S-RIGHT)}}}   | One day forward.                       |
-- 
2.27.0

Re: [PATCH] doc: Document C-. for jumping to today when choosing a timestamp

[Bastien]

Hi Adam,

Adam Spiers <orgmode@adamspiers.org> writes:

> This useful key binding was previously missing from the manual.

Thanks for spotting this.  I added it (as 2df7a8fa) together with
the `.'  keybinding, which achieves the same.

Best,

-- 
 Bastien

Re: [PATCH] doc: Document C-. for jumping to today when choosing a timestamp

[Adam Spiers]

On Fri, Sep 04, 2020 at 03:47:08PM +0200, Bastien wrote:
>Hi Adam,
>
>Adam Spiers <orgmode@adamspiers.org> writes:
>
>> This useful key binding was previously missing from the manual.
>
>Thanks for spotting this.  I added it (as 2df7a8fa) together with
>the `.'  keybinding, which achieves the same.

Thanks Bastien.  There's actually a subtle but important difference
between the two: when editing a timestamp with a time of day in, e.g.

     <2020-08-27 Thu 17:00>

then the prompt in the minibuffer will be:

     SCHEDULED Date+time [2020-08-27]: 17:00

While the point is after the "17:00", pressing '.' does not cause a
jump to today's date; instead it just appends the '.' character after
the "17:00".  In contrast, C-. successfully jumps to today without
altering the prompt input.  So in this context, C-. is far more useful
than just '.'.

Funnily enough I found that if I first jump to the beginning of
"17:00" via C-a, then they do indeed behave identically.

Re: [PATCH] doc: Document C-. for jumping to today when choosing a timestamp

[Bastien]

Hi Adam,

Adam Spiers <orgmode@adamspiers.org> writes:

> There's actually a subtle but important difference
> between the two: when editing a timestamp with a time of day in, e.g.
>
>     <2020-08-27 Thu 17:00>
>
> then the prompt in the minibuffer will be:
>
>     SCHEDULED Date+time [2020-08-27]: 17:00
>
> While the point is after the "17:00", pressing '.' does not cause a
> jump to today's date; instead it just appends the '.' character after
> the "17:00".  In contrast, C-. successfully jumps to today without
> altering the prompt input.  So in this context, C-. is far more useful
> than just '.'.

Indeed!  I slightly updated the manual with 0b9080421 in maint.

Thanks,

-- 
 Bastien