Bug: Toggle descriptive and literal links [7.4]

Bug: Toggle descriptive and literal links [7.4]

[Reiner Steib]

Hi,

in the "Org" menu, the are the following toggles:

- <menu-bar> <Org> <Hyperlinks> <Descriptive Links>
- <menu-bar> <Org> <Hyperlinks> <Literal Links>

There are two (related) issues wit this:

(a) There is no (interactive) command to toggle this setting.

Here is what I use:

#+BEGIN_SRC lisp
   (defun org-descriptive-links ()
     "Display Descriptive Links in `org-mode'."
     (interactive)
     (org-add-to-invisibility-spec '(org-link)) (org-restart-font-lock))

   (defun org-literal-links ()
     "Display Literal Links in `org-mode'."
     (interactive)
     (org-remove-from-invisibility-spec '(org-link)) (org-restart-font-lock))
#+END_SRC

I'd suggest to add such `defun's (or a toggling defun) and adjust
org-org-menu accordingly to use the defuns instead of the current
`progs'.

(b) The initial behaviour should be customizable.


Bye, Reiner

Re: Bug: Toggle descriptive and literal links [7.4]

[Bastien]

Hi Reiner,

Reiner Steib <reinersteib+gmane@imap.cc> writes:

> (a) There is no (interactive) command to toggle this setting.

There is now `org-toggle-link-display'.

> #+BEGIN_SRC lisp
>    (defun org-descriptive-links ()
>      "Display Descriptive Links in `org-mode'."
>      (interactive)
>      (org-add-to-invisibility-spec '(org-link)) (org-restart-font-lock))
>
>    (defun org-literal-links ()
>      "Display Literal Links in `org-mode'."
>      (interactive)
>      (org-remove-from-invisibility-spec '(org-link)) (org-restart-font-lock))
> #+END_SRC

Thanks for the example code.

> I'd suggest to add such `defun's (or a toggling defun) and adjust
> org-org-menu accordingly to use the defuns instead of the current
> `progs'.

Done.

> (b) The initial behaviour should be customizable.

See the new option: `org-link-display-descriptive' which defaults to
`t'.

Thanks for this idea!

-- 
 Bastien

Re: Bug: Toggle descriptive and literal links [7.4]

[Thomas S. Dye]

Bastien <bzg@altern.org> writes:

> Hi Reiner,
>
> Reiner Steib <reinersteib+gmane@imap.cc> writes:
>
>> (a) There is no (interactive) command to toggle this setting.
>
> There is now `org-toggle-link-display'.
>
>> #+BEGIN_SRC lisp
>>    (defun org-descriptive-links ()
>>      "Display Descriptive Links in `org-mode'."
>>      (interactive)
>>      (org-add-to-invisibility-spec '(org-link)) (org-restart-font-lock))
>>
>>    (defun org-literal-links ()
>>      "Display Literal Links in `org-mode'."
>>      (interactive)
>>      (org-remove-from-invisibility-spec '(org-link)) (org-restart-font-lock))
>> #+END_SRC
>
> Thanks for the example code.
>
>> I'd suggest to add such `defun's (or a toggling defun) and adjust
>> org-org-menu accordingly to use the defuns instead of the current
>> `progs'.
>
> Done.
>
>> (b) The initial behaviour should be customizable.
>
> See the new option: `org-link-display-descriptive' which defaults to
> `t'.
>
> Thanks for this idea!

Aloha Bastien,

Thanks for adding this.  I work with literal links and this potentially
saves time and effort.

I wonder if I'm using it correctly?  In .emacs I set
org-link-display-descriptive nil and have:

--------
org-link-display-descriptive is a variable defined in `org.el'.
Its value is nil

Documentation:
Non-nil means Org will display descriptive links.
E.g. [[http://orgmode.org][Org website]] will be displayed as
"Org Website", hiding the link itself and just displaying its
description.  When set to `nil', Org will display the full links
literally.

You can interactively set the value of this variable using the
`org-toggle-link-display'.
--------

But when I open an Org-mode buffer I find the links displayed
descriptively.  The menu Org/Hyperlinks/Literal Links is checked at this
time.  If I call org-toggle-link-display twice, then literal links are
displayed.

All the best,
Tom
-- 
Thomas S. Dye
http://www.tsdye.com

Re: Bug: Toggle descriptive and literal links [7.4]

[Bastien]

Hi Thomas,

tsd@tsdye.com (Thomas S. Dye) writes:

> Thanks for adding this.  I work with literal links and this potentially
> saves time and effort.
>
> I wonder if I'm using it correctly?  In .emacs I set
> org-link-display-descriptive nil and have:
>
> --------
> org-link-display-descriptive is a variable defined in `org.el'.
> Its value is nil
>
> Documentation:
> Non-nil means Org will display descriptive links.
> E.g. [[http://orgmode.org][Org website]] will be displayed as
> "Org Website", hiding the link itself and just displaying its
> description.  When set to `nil', Org will display the full links
> literally.
>
> You can interactively set the value of this variable using the
> `org-toggle-link-display'.
> --------
>
> But when I open an Org-mode buffer I find the links displayed
> descriptively.  

The initialization of the link display relied on 
`org-descriptive-links' and I discover this variable (doh!)

So I've now remove `org-link-display-descriptive' and use
`org-descriptive-links' instead for backward compatibility.  

Please use this variable too and let me know if things are
all right now.

Best,

-- 
 Bastien

Re: Bug: Toggle descriptive and literal links [7.4]

[Thomas S. Dye]

Bastien <bzg@altern.org> writes:

> Hi Thomas,
>
> tsd@tsdye.com (Thomas S. Dye) writes:
>
>> Thanks for adding this.  I work with literal links and this potentially
>> saves time and effort.
>>
>> I wonder if I'm using it correctly?  In .emacs I set
>> org-link-display-descriptive nil and have:
>>
>> --------
>> org-link-display-descriptive is a variable defined in `org.el'.
>> Its value is nil
>>
>> Documentation:
>> Non-nil means Org will display descriptive links.
>> E.g. [[http://orgmode.org][Org website]] will be displayed as
>> "Org Website", hiding the link itself and just displaying its
>> description.  When set to `nil', Org will display the full links
>> literally.
>>
>> You can interactively set the value of this variable using the
>> `org-toggle-link-display'.
>> --------
>>
>> But when I open an Org-mode buffer I find the links displayed
>> descriptively.  
>
> The initialization of the link display relied on 
> `org-descriptive-links' and I discover this variable (doh!)
>
> So I've now remove `org-link-display-descriptive' and use
> `org-descriptive-links' instead for backward compatibility.  
>
> Please use this variable too and let me know if things are
> all right now.
>
> Best,

Aloha Bastien,

I pulled from git and put this in .emacs:

  (setq org-descriptive-links nil)

Now links display as expected on startup.

Thanks for looking into this.

All the best,
Tom

-- 
Thomas S. Dye
http://www.tsdye.com