emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [PATCH] doc: Document C-. for jumping to today when choosing a timestamp
@ 2020-08-29 22:47 Adam Spiers
  2020-09-04 13:47 ` Bastien
  0 siblings, 1 reply; 4+ messages in thread
From: Adam Spiers @ 2020-08-29 22:47 UTC (permalink / raw)
  To: emacs-orgmode

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



^ permalink raw reply related	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: Document C-. for jumping to today when choosing a timestamp
  2020-08-29 22:47 [PATCH] doc: Document C-. for jumping to today when choosing a timestamp Adam Spiers
@ 2020-09-04 13:47 ` Bastien
  2020-09-05 16:18   ` Adam Spiers
  0 siblings, 1 reply; 4+ messages in thread
From: Bastien @ 2020-09-04 13:47 UTC (permalink / raw)
  To: Adam Spiers; +Cc: emacs-orgmode

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


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: Document C-. for jumping to today when choosing a timestamp
  2020-09-04 13:47 ` Bastien
@ 2020-09-05 16:18   ` Adam Spiers
  2020-09-06  5:53     ` Bastien
  0 siblings, 1 reply; 4+ messages in thread
From: Adam Spiers @ 2020-09-05 16:18 UTC (permalink / raw)
  To: Bastien; +Cc: emacs-orgmode

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.


^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] doc: Document C-. for jumping to today when choosing a timestamp
  2020-09-05 16:18   ` Adam Spiers
@ 2020-09-06  5:53     ` Bastien
  0 siblings, 0 replies; 4+ messages in thread
From: Bastien @ 2020-09-06  5:53 UTC (permalink / raw)
  To: Adam Spiers; +Cc: emacs-orgmode

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


^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2020-09-06  5:53 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-08-29 22:47 [PATCH] doc: Document C-. for jumping to today when choosing a timestamp Adam Spiers
2020-09-04 13:47 ` Bastien
2020-09-05 16:18   ` Adam Spiers
2020-09-06  5:53     ` Bastien

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).