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.