org-mode 4.64

org-mode 4.64

[Carsten Dominik]

Hi,

I have released version 4.64 at

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

Enjoy.

- Carsten

Changes in Version 4.64
-----------------------

* Overview

   - Email links get better, configurable descriptions
   - When inserting a link, selected text becomes the description
   - Easier access to the list of stored links.
   - Horizontal lines in HTML export.
   - Remember templates and storing of notes improved.

* Detailed description of changes

   - The descriptive part of links to email messages can be configured
     using the variable `org-email-link-description-format'.  The new
     default is "Email %c: %.30s" and leads to

        Email from NAME: SUBJECT

     If you configure the variable `org-from-is-user-regexp'
     correctly, then for email you *sent* this will actually change to

        Email to NAME: SUBJECT

     The subject is limited to 30 characters.  If you have become
     attached to the previous default (look twice, the new one is
     better), use "%f on: %s" as your format.

   - Selecting text before entering a new link with C-c C-l now really
     works, the selected text becomes the description part of the
     link.  Requested by Scott, buggy 4.62 implementation is now fixed.

   - Stored links are part of the history list for C-c C-l, so to
     reach them, you can use up/down rather than completion.  Thanks
     to Raman for this excellent idea.

   - A line consisting only of "-", and at least 5 of them, is
     exported into HTML as <hr/>, as proposed by Giovanni Ridolfi.

   - Several changes to org <-> remember integration

       - You can use `org-remember' as your default command to start
         remember.  It will automatically detect if there is an active
         region and use it as initial content (we will probably make
         remember.el work like this as well).
         Also, when calling `org-remember' in a remember buffer that
         was created with a template, you will again be asked to
         select a template.  The buffer is then re-created with the
         new template, but the old context information.  This is
         useful if you change your mind about the template to use
         (Leo's idea).

       - Besides specifying a default *target* file for a note, you
         can also give a default *heading* of which the note should
         become a subitem.  In many cases this avoids or speeds up
         navigating to the right location.  Both file and heading can
         be different for each template.  Both are non-binding, you
         can change them while storing the note.  However, when you
         exit remember with C-u C-c C-c, these defaults will be used
         without interaction.

       - Templates can specify interactive fields.  During expansion
         of the template, you will be prompted for the information in
         that field.  For example %^t will pop up a calendar and ask
         you to select a date. This new feature follows a proposal
         from Leo, who in the mean time has said he does not need it
         anymore.  But I liked it, so here it is :-)

       - Templates can access information specific to the link type
         created, for example the author and subject of an email.
         Syntax is %:fromname, %:fromaddress, %:subject etc, details
         in the manual.  Proposed by Peder O. Klingenberg.

       - I have been considering to move, at some stage, the template
         functionality into remember.el itself - which would of course
         require consent of the remember.el maintainers.  I am not
         sure how well this would work though, since some things like
         the interactive time stamps are org.el specific, so treating
         them would require special hooks.  Comments?

Re: org-mode 4.64

[Leo]

On 2007-02-06, Carsten Dominik said:

> Hi,
>
> I have released version 4.64 at
>
> http://www.astro.uva.nl/~dominik/Tools/org
>
> Enjoy.
>
> - Carsten

Thank you, Carsten.

This will keep me busy for a while. I enjoy exploring new features of
org.

BTW, I found a typo in org-remember:
,----[ typo ]
| org-remember is an interactive compiled Lisp function in `org.el'.
| (org-remember)
| 
| Call `remember'.  If this is already a remember buffer, re-apply template.
| If there is an active region, *amke* sure remember uses it as initial content
| of the remember buffer.
`----

Regards,
-- 
Leo <sdl.web AT gmail.com>                         (GPG Key: 9283AA3F)

Re: org-mode 4.64

[Leo]

Thank you, Carsten for this wonderful package with constant
improvement.

On 2007-02-06, Carsten Dominik said:

[...]
> * Detailed description of changes
>
>   - The descriptive part of links to email messages can be configured
>     using the variable `org-email-link-description-format'.  The new
>     default is "Email %c: %.30s" and leads to
>
>        Email from NAME: SUBJECT

Very nice feature. The issue is it usually break in the middle of a
word which made the description look odd. Can it be improved to do
either of the following:

      1) if the break position is in the middle of a word, include that
         word.
      2) add '...' (just an example) to the end of the break position

I don't know which one is better though I like 1) more.

[...]
>   - A line consisting only of "-", and at least 5 of them, is
>     exported into HTML as <hr/>, as proposed by Giovanni Ridolfi.

Slowly more and more mark up rules are introduced into org. Is there a
standard/popular Wiki Markup rules we can use for org, maybe like the
one used for emacswiki? Any other suggestions?

[...]
>       - I have been considering to move, at some stage, the template
>         functionality into remember.el itself - which would of course
>         require consent of the remember.el maintainers.  I am not
>         sure how well this would work though, since some things like
>         the interactive time stamps are org.el specific, so treating
>         them would require special hooks.  Comments?

The template functionality seems generally useful. So I think move it
to remember is a good choice.

-- 
Leo <sdl.web AT gmail.com>                         (GPG Key: 9283AA3F)

Re: org-mode 4.64

[CHENG Gao]

It's really great news.

I just have a suggestion. While not install org into its own subdir
instead of site-lisp? Everytime I need to edit Makefile to install it
into site-lisp/org.

Re: org-mode 4.64

[Bastien]

Hi Carsten,

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

>   - Several changes to org <-> remember integration

I played a bit with all these features, and they are great.  I hope
i'll actually *need/use* them someday :)

>       - Besides specifying a default *target* file for a note, you
>         can also give a default *heading* of which the note should
>         become a subitem.  

I first thought a heading was something like "* Notes" and found out
that "Notes" was enough.  Maybe the documentation should be more
explicit on this point.

>         However, when you exit remember with C-u C-c C-c, these
>         defaults will be used without interaction.

C-u C-c C-c bypasses any specifications of the heading.  It inserts
the note just on the top of it.  C-c C-c works okay.

>       - Templates can specify interactive fields.  

Very nice!

>       - Templates can access information specific to the link type
>         created, for example the author and subject of an email.
>         Syntax is %:fromname, %:fromaddress, %:subject etc, details
>         in the manual.  Proposed by Peder O. Klingenberg.

I cannot get any of the keyword to work.  Here are my templates:

(setq org-remember-templates
      '((?n "* %?\n  %i\n  %a %:url" "~/org/notes.org" "Notes")
	(?j "* %U %?\n\n  %i\n  %a" "~/org/journal.org" "Notes")))

I tested the "?n"-template from a w3m page and it just inserts the
string "%:url", not the URL itself.  Anyone any hint? Peter?

-- 
Bastien