Remember templates and time stamp rounding.

Remember templates and time stamp rounding.

[Carsten Dominik]

I have put a new test version of org.el onto my site, version 4.11a:

    http://www.astro.uva.nl/~dominik/Tools/org/org-test.zip

This contains only org.el, no further documentation.

In this test version, I have incorporates Alex' time rounding patch
(in a modified version).  Also there is support for templates for
remember.

Time-stamp rounding
-------------------

The default is no rounding of time stamps.

I originally thought that every place in the code using times should
honor the rounding variable, but with some more thinking I now agree
with Alex that it is enough to do that in the few commands that
actually insert a time corresponding to the current time.  That means
that you can still modify times either by entering them at the
time/date prompt, or by using the S-cursor keys, and these
modifications will not be modified by the rounding setting.  One
change I added is that if you use a double C-u for a time stamp
command, then the default time is exact, not rounded.  In this way you
can use rounded times most of the time, but still get an exact time if
you need it.  Thanks to Alex for the patch (and also for the bug fix
in org-read-date, in the string-replacement...).


Remember templates
------------------

To activate the templates you need, in addition to the other remember
configuration, this line in .emacs:

     (add-hook 'remember-mode-hook 'org-remember-apply-template)

If you don't set any templates, then the only change you will notice
with the new code is that the remember buffer is now in org-mode, so
that you can use all the org-mode commands.  You need to exit with C-c
C-c.  Normally remember also allows C-x C-s, but this is not possible
anymore in my version, for technical reasons.

There is a new variable, org-remember-templates, which can be set to a
list of templates to use.  If you only specify a single template, it
will always be used.  If you specify several templates, then each time
you use remember you need to hit one additional character to select a
template.  That is why you need to specify a selection character for
each template.

In the template you can use several % escape sequences to insert
information like a time stamp, this annotation link to the original
file etc, please check the documentation string of
`org-remember-templates' for the full list.

Following the discussion here, I am providing 2 examples:

;; Template for Charles Cave's journal file.
(setq org-remember-templates
       '((?j . "* Topic: %T %?\n")))

;; Templates for Philip Rooke, journal and TODO with a deadline of today
(setq org-remember-templates
       '((?j . "* %U %?\n  %i\n\n  %a")
	(?t . "* TODO %?\n  DEADLINE: %T\n   %i\n\n   %a")))

I think this might be a flexible way to set things up.  Give it a try
and let us know what additional % escapes and/or other
changes you think would be useful.

- Carsten


--
Carsten Dominik
Sterrenkundig Instituut "Anton Pannekoek"
Universiteit van Amsterdam
Kruislaan 403
NL-1098SJ Amsterdam
phone: +31 20 525 7477

Re: Remember templates and time stamp rounding.

[Alex Bochannek]

Carsten Dominik <dominik@science.uva.nl> writes:

> Time-stamp rounding
> -------------------

Thanks for including it!


Couple other quick ones:

(defcustom org-popup-calendar-for-date-prompt t
  ...
  :group 'org-time
  :type 'number)

That should really be a :type 'boolean


For the emphasis font-locks, these regexps work well for me:

(if em '("\\([[:punct:][:space:]]\\|^\\)\\(\\*\\([^*[:space:]]+\\)\\*\\)\\([[:space:][:punct:]]\\|$\\)" 0 'bold))
(if em '("\\([[:punct:][:space:]]\\|^\\)\\(/\\([^/[:space:]]+\\)/\\)\\([[:space:][:punct:]]\\|$\\)" 0 'italic))
(if em '("\\([[:punct:][:space:]]\\|^\\)\\(_\\([^_[:space:]]+\\)_\\)\\([[:space:][:punct:]]\\|$\\)" 0 'underline))


Alex.

Re: Remember templates and time stamp rounding.

[Alex Bochannek]

Carsten Dominik <dominik@science.uva.nl> writes:

>> For the emphasis font-locks, these regexps work well for me:
>>
>> (if em  '("\\([[:punct:][:space:]]\\|^\\)\\(\\*\\([^*[:
>> space:]]+\\)\\*\\)\\([[:space:][:punct:]]\\|$\\)" 0 'bold))
>> (if em
>> ("\\([[:punct:][:space:]]\\|^\\)\\(/\\([^/[:space:]]+\\)/\\)\\([[:
>> space:][:punct:]]\\|$\\)" 0 'italic))
>> (if em
>> ("\\([[:punct:][:space:]]\\|^\\)\\(_\\([^_[:space:]]+\\)_\\)\\([[:
>> space:][:punct:]]\\|$\\)" 0 'underline))
>
> Hi Alex, what is wrong with the expressions I have in org.el?

The issue was that there would be no emphasis added when there was
punctuation before or after it. Punctuation inside would also break
it. Finally, I think the :space: character class is a bit more
inclusive than what you used, but I don't recall for sure.

Basically, the regexp above says:

punctuation or white space or beginning of line
 followed by the emphasis character
  at least one non-emphasis or space character
 followed by the emphasis character
punctuation or white space or end of line

I seem to recall that I ran into an issue when I did something like:
*foo-bar* and it wouldn't emphasize.

By the way, I am also leaning towards allowing multiple tokens that
are separated by one space since I sometimes would use it to emphasize
commands like: *ls -l*.

Maybe this would be better:

'("\\([[:punct:][:space:]]\\|^\\)\\(\\*\\([^*[:space:]]+\\)\\( \\([^*[:space:]]+\\)\\)*\\*\\)\\([[:space:][:punct:]]\\|$\\)" 0 'bold)

Alex.

Re: Remember templates and time stamp rounding.

[Philip Rooke]

Carsten Dominik <dominik@science.uva.nl> writes:

> I have put a new test version of org.el onto my site, version 4.11a:

[...]

> Remember templates 
> ------------------

[...]

> ;; Templates for Philip Rooke, journal and TODO with a deadline of today
> (setq org-remember-templates
>       '((?j . "* %U %?\n  %i\n\n  %a")
> 	(?t . "* TODO %?\n  DEADLINE: %T\n   %i\n\n   %a")))
>
> I think this might be a flexible way to set things up.  Give it a try
> and let us know what additional % escapes and/or other
> changes you think would be useful.

I've had the chance to check these examples and they are working
fantastically well for me.  Thank you very much.

Regards,

Phil

Re: Remember templates and time stamp rounding.

[Jason F. McBrayer]

Philip Rooke <phil@yax.org.uk> writes:

> Carsten Dominik <dominik@science.uva.nl> writes:
>
>> I have put a new test version of org.el onto my site, version 4.11a:
>
> [...]
>
>> Remember templates 
>> ------------------
>
> [...]
>
> I've had the chance to check these examples and they are working
> fantastically well for me.  Thank you very much.

I'd like to add a "me too" here.  These patches are working well for
me.  The templates I am using are:

(setq org-remember-templates
     '((?j . "* %?\n  %U\n  %i\n\n  %a")
       (?n . "* NEXTACTION %?\n  %T\n   %i\n\n   %a")
       (?d . "* NEXTACTION %?\n  DEADLINE: %T\n   %i\n\n   %a")  
       (?s . "* NEXTACTION %?\n  SCHEDULED: %T\n  %i\n\n   %a")))


-- 
+----------------------------------------------------------------+
| Jason F. McBrayer                         jmcbray@carcosa.net  |
|  "If you wish to make Pythocles wealthy, don't give him more   |
|   money; rather, reduce his desires."            -- Epicurus   |