org-lint and org-attach DIR property

org-lint and org-attach DIR property

[Gustavo Barros]

Hi All,

When setting the 'DIR' property for attachments for a whole file with 
=#+PROPERTY: DIR ...=, 'org-lint' will issue a deprecation warning and 
recommend the use "header-args" instead.  Of course, 'org-lint' means 
here babel blocks, but as far as I understand, setting the 'DIR' 
property for attachments for the whole file this way is a legitimate use 
case, and is the only way to do so for org-attach.  If this is the case, 
the warning issued by 'org-lint' might be misleading.  I'm admittedly 
not well acquainted with 'org-lint', but thought it worth to bring the 
case to your attention, for your consideration.

To generate such a warning, starting with =emacs -Q=, set load-path to 
get the proper version of Org (as your case may be):

#+begin_src emacs-lisp
(add-to-list 'load-path "~/.emacs.d/elpa/org-plus-contrib-20200608")
#+end_src

Then visit an Org file with following contents:

#+begin_src org
,#+property: DIR attachments

,* entry1

,* entry2
#+end_src

'org-lint' will return:

#+begin_example
1 low   Deprecated syntax for "DIR".  Use header-args instead
#+end_example

This was tested with "Org mode version 9.3.7 (9.3.7-2-g706970-elpaplus @ 
/home/gustavo/.emacs.d/elpa/org-plus-contrib-20200608/)" and "GNU Emacs 
27.0.91 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.22.30, cairo 
version 1.15.10) of 2020-05-20".

Best,
Gustavo.

Re: org-lint and org-attach DIR property

[Nicolas Goaziou]

Hello,

Gustavo Barros <gusbrs.2016@gmail.com> writes:

> When setting the 'DIR' property for attachments for a whole file with 
> =#+PROPERTY: DIR ...=, 'org-lint' will issue a deprecation warning and 
> recommend the use "header-args" instead.  Of course, 'org-lint' means 
> here babel blocks, but as far as I understand, setting the 'DIR' 
> property for attachments for the whole file this way is a legitimate use 
> case, and is the only way to do so for org-attach.  If this is the case, 
> the warning issued by 'org-lint' might be misleading.  I'm admittedly 
> not well acquainted with 'org-lint', but thought it worth to bring the 
> case to your attention, for your consideration.

[...]

> Then visit an Org file with following contents:
>
> #+begin_src org
> ,#+property: DIR attachments
>
> ,* entry1
>
> ,* entry2
> #+end_src

You are right. I removed the warning for dir property. Thank you.

Regards,

-- 
Nicolas Goaziou

Re: org-lint and org-attach DIR property

[Gustavo Barros]

Hi Nicolas,

On Fri, 12 Jun 2020 at 18:59, Nicolas Goaziou <mail@nicolasgoaziou.fr> 
wrote:

>
> I removed the warning for dir property. Thank you.
>

Thank you very much.

Regards,
Gustavo.