how to use org-lint

how to use org-lint

[Gregor Zattler]

Dear org-mode users and developers,

when I do M-x org-lint while the active cpoint is in a org-mode
buffer nothing happens.

When I do M-: (org-lint) I get for instance;

((1 ["118" "high" "Incorrect location for PROPERTIES drawer" [cl-struct-org-lint-checker obsolete-properties-drawer "Report obsolete syntax for properties drawers" ... high]]) (2 ["922" "high" "Duplicate footnote definition \"1\"" [cl-struct-org-lint-checker duplicate-footnote-definition "Report duplicate footnote definitions" ... high]]) (3 ["1018" "high" "Incorrect location for PROPERTIES drawer" [cl-struct-org-lint-checker obsolete-properties-drawer "Report obsolete syntax for properties drawers" ... high]]) (4 ["1144" "low" "Misplaced planning info line" [cl-struct-org-lint-checker misplaced-planning-info "Report misplaced planning info line" ... low]]) (5 ["1257" "high" "Missing definition for footnote [fn:BMG]" [cl-struct-org-lint-checker undefined-footnote-reference "Report missing definition for footnote references" ... high]]) (6 ["1257" "high" "Missing definition for footnote [fn:AGHF]" [cl-struct-org-lint-checker undefined-footnote-reference "Report missing definition for footnote references" ... high]]) (7 ["1257" "high" "Missing definition for footnote [fn:AGHF]" [cl-struct-org-lint-checker undefined-footnote-reference "Report missing definition for footnote references" ... high]]) (8 ["1257" "high" "Missing definition for footnote [fn:AGHF]" [cl-struct-org-lint-checker undefined-footnote-reference "Report missing definition for footnote references" ... high]]) (9 ["1264" "high" "Missing definition for footnote [fn:BMG]" [cl-struct-org-lint-checker undefined-footnote-reference "Report missing definition for footnote references" ... high]]) (10 ["1268" "high" "Missing definition for footnote [fn:AGHF]" [cl-struct-org-lint-checker undefined-footnote-reference "Report missing definition for footnote references" ... high]]) (11 ["5201" "high" "Incorrect location for PROPERTIES drawer" [cl-struct-org-lint-checker obsolete-properties-drawer "Report obsolete syntax for properties drawers" ... high]]) (12 ["5220" "high" "Incorrect location for PROPERTIES drawer" [cl-struct-org-lint-checker obsolete-properties-drawer "Report obsolete syntax for properties drawers" ... high]]) ...)

in the *Message*  Buffer.

How do I interpret this message?  I would like to fix my org-mode
files but do not know how to with this messages.

I remember vaguely that thee used to be a nicely formatted
results buffer?  

This is on
GNU Emacs 25.0.50.2 (i686-pc-linux-gnu, GTK+ Version 3.14.5) of 2015-10-14
Org-mode version 8.3.2 (release_8.3.2-175-gfa61cb @/home/grfz/src/org-mode/lisp/)

Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-

Re: how to use org-lint

[Nicolas Goaziou]

Hello,

Gregor Zattler <telegraph@gmx.net> writes:

> when I do M-x org-lint while the active cpoint is in a org-mode
> buffer nothing happens.

M-x org-lint should create an "*Org lint*" buffer somewhere. Maybe it is
buried or on another frame.


Regards,

-- 
Nicolas Goaziou

Re: how to use org-lint

[Gregor Zattler]

Hi Nicolas,
* Nicolas Goaziou <mail@nicolasgoaziou.fr> [14. Oct. 2015]:
> Gregor Zattler <telegraph@gmx.net> writes:
> 
>> when I do M-x org-lint while the active cpoint is in a org-mode
>> buffer nothing happens.
> 
> M-x org-lint should create an "*Org lint*" buffer somewhere. Maybe it is
> buried or on another frame.

When I do this, nothing happens, there is no buffer *Org lint*.

When I do M-: (org-int) it takes a second or two but there is no
*Org-lint* buffer and only this info in *Messages* (I XXXed personal info):


Debug (ox-odt): Searching for OpenDocument styles files...
Debug (ox-odt): Trying /usr/share/emacs/etc/org/styles/... [2 times]
Debug (ox-odt): Trying /home/grfz/src/etc/styles/...
Debug (ox-odt): Trying /home/grfz/src/org-mode/lisp/etc/styles/...
Debug (ox-odt): Trying /usr/local/stow/emacs-snapshot/share/emacs/25.0.50/etc/org/...
Debug (ox-odt): Using styles under /usr/local/stow/emacs-snapshot/share/emacs/25.0.50/etc/org/
Debug (ox-odt): Searching for OpenDocument schema files...
Debug (ox-odt): Trying /usr/share/emacs/etc/org/schema/... [2 times]
Debug (ox-odt): No OpenDocument schema files installed
((1 ["2395" "low" "Possible incomplete block \"#+BEGIN: clocktable  :tstart \"2015-01-01\" :tend \"<now>\" :narrow 80! :minlevel 2 :maxlevel 14 :scope agenda :tags \"job\" :stepskip0 :fileskip0 :link :indent\"" [cl-struct-org-lint-checker invalid-block "Report invalid blocks" ... low]]) (2 ["2440" "low" "Invalid block closing line \"#+END: clocktable\"" [cl-struct-org-lint-checker invalid-block "Report invalid blocks" ... low]]) (3 ["2459" "low" "Misplaced planning info line" [cl-struct-org-lint-checker misplaced-planning-info "Report misplaced planning info line" ... low]]) (4 ["2463" "low" "Misplaced planning info line" [cl-struct-org-lint-checker misplaced-planning-info "Report misplaced planning info line" ... low]]) (5 ["2545" "low" "Misplaced planning info line" [cl-struct-org-lint-checker misplaced-planning-info "Report misplaced planning info line" ... low]]) (6 ["2736" "low" "Misplaced planning info line" [cl-struct-org-lint-checker misplaced-planning-info "Report misplaced planning info line" ... low]]) (7 ["3462" "high" "Unknown fuzzy location \" -e \"$envfile\" \"" [cl-struct-org-lint-checker invalid-fuzzy-link "Report \"fuzzy\" links with unknown destination" ... high]]) (8 ["3570" "high" "Unknown fuzzy location \"gitready.com\"" [cl-struct-org-lint-checker invalid-fuzzy-link "Report \"fuzzy\" links with unknown destination" ... high]]) (9 ["3589" "low" "Link to non-existent local file \"~/src/progit/figures/18333fig0106-tn.png\"" [cl-struct-org-lint-checker link-to-local-file "Report links to non-existent local files" ... low]]) (10 ["3603" "low" "Link to non-existent local file \"~/src/progit/figures/18333fig0201-tn.png\"" [cl-struct-org-lint-checker link-to-local-file "Report links to non-existent local files" ... low]]) (11 ["3647" "high" "Unknown fuzzy location \"XXX%20XXX%C3%9F%20iXX20XXXX%20XXXXX%20XXXXXXXXXXX,%20XXXX%20XXX%20XXXXXXX,%20XXXX%20XXXX%0AXXXX%20XXXX%20XXXXXXXXXX\"" [cl-struct-org-lint-checker invalid-fuzzy-link "Report \"fuzzy\" links with unknown destination" ... high]]) (12 ["4907" "low" "Misplaced planning info line" [cl-struct-org-lint-checker misplaced-planning-info "Report misplaced planning info line" ... low]]) ...)


Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-

Re: how to use org-lint

[Nicolas Goaziou]

Gregor Zattler <telegraph@gmx.net> writes:

> When I do this, nothing happens, there is no buffer *Org lint*.

You may want to debug `org-lint', or probably
`org-lint--display-reports' then.

> When I do M-: (org-int) it takes a second or two but there is no
> *Org-lint* buffer and only this info in *Messages* (I XXXed personal
> info):

In non-interactive mode, `org-lint' spits out reports for further
processing, or nil when all lights are green. IOW, this is to be
expected.

Regards,

org-lint complains about planning info line in inline task (was: Re: how to use org-lint)

[Gregor Zattler]

Hi Nicolas, org-mode developers,

org-lint cpmlains:
 10702 low   Misplaced planning info line

because of this:

***************************** DONE XXXX xxx XXXXX xxxxx Xxxxxxxxx
  DEADLINE: <2011-11-25 Fr>   CLOSED: [2011-12-17 Sa 21:42]  
  <2011-11-22 Di>
  :LOGBOOK:
  - State "DONE"       from "TODO"       [2011-12-17 Sa 21:42] \\
    erledigt
  :END:
***************************** END

is it right to do so?  I thought planning info lines go right
below the headline?

Ciao; Gregor

P.S.: Regarding the problem described below: org-lint worked with
Emacs-snapshot -Q, so I bisected my init.el.  Now it works while
nothing relvant changed with respect to the init.el!?  Strange.

* Nicolas Goaziou <mail@nicolasgoaziou.fr> [15. Oct. 2015]:
> Gregor Zattler <telegraph@gmx.net> writes:
> 
>> When I do this, nothing happens, there is no buffer *Org lint*.
> 
> You may want to debug `org-lint', or probably
> `org-lint--display-reports' then.
> 
>> When I do M-: (org-int) it takes a second or two but there is no
>> *Org-lint* buffer and only this info in *Messages* (I XXXed personal
>> info):
> 
> In non-interactive mode, `org-lint' spits out reports for further
> processing, or nil when all lights are green. IOW, this is to be
> expected.
> 
> Regards,
> 
> 

Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-

Re: org-lint complains about incorrect contents for PROPERTIES drawer in inline task (was: Re: how to use org-lint)

[Gregor Zattler]

Hi Nicolas, org-mode developers,

I fixed another org-mode file and there is another strange
behaviour of org-lint:

org-lint complains:
  9846 high  Incorrect contents for PROPERTIES drawer

because of this:

***************************** watermelon watermelon watermelon
      :PROPERTIES:
      :CREATED: <2013-07-10 Mi 16:40>
      :END:
      <2013-07-11 Do>
***************************** END

In order to fix it I recreated this inline task (C-c C-x t) and
its PROPERTIES drawer (C-u M-x org-insert-drawer) and the
specified property (C-c C-x p).  Org-lint complains nonetheless.

What to do?

Ciao; Gregor 


* Gregor Zattler <telegraph@gmx.net> [16. Oct. 2015]:
> org-lint cpmlains:
>  10702 low   Misplaced planning info line
> 
> because of this:
> 
> ***************************** DONE XXXX xxx XXXXX xxxxx Xxxxxxxxx
>   DEADLINE: <2011-11-25 Fr>   CLOSED: [2011-12-17 Sa 21:42]  
>   <2011-11-22 Di>
>   :LOGBOOK:
>   - State "DONE"       from "TODO"       [2011-12-17 Sa 21:42] \\
>     erledigt
>   :END:
> ***************************** END
> 
> is it right to do so?  I thought planning info lines go right
> below the headline?
> 
> Ciao; Gregor
> 
> P.S.: Regarding the problem described below: org-lint worked with
> Emacs-snapshot -Q, so I bisected my init.el.  Now it works while
> nothing relvant changed with respect to the init.el!?  Strange.
> 
> * Nicolas Goaziou <mail@nicolasgoaziou.fr> [15. Oct. 2015]:
>> Gregor Zattler <telegraph@gmx.net> writes:
>> 
>>> When I do this, nothing happens, there is no buffer *Org lint*.
>> 
>> You may want to debug `org-lint', or probably
>> `org-lint--display-reports' then.
>> 
>>> When I do M-: (org-int) it takes a second or two but there is no
>>> *Org-lint* buffer and only this info in *Messages* (I XXXed personal
>>> info):
>> 
>> In non-interactive mode, `org-lint' spits out reports for further
>> processing, or nil when all lights are green. IOW, this is to be
>> expected.
>> 
>> Regards,
>> 
>> 
> 
> Ciao, Gregor
> -- 
>  -... --- .-. . -.. ..--.. ...-.-
> 
> 

Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-

Re: org-lint complains about planning info line in inline task

[Nicolas Goaziou]

Hello,

Gregor Zattler <telegraph@gmx.net> writes:

> org-lint cpmlains:
>  10702 low   Misplaced planning info line
>
> because of this:
>
> ***************************** DONE XXXX xxx XXXXX xxxxx Xxxxxxxxx
>   DEADLINE: <2011-11-25 Fr>   CLOSED: [2011-12-17 Sa 21:42]  
>   <2011-11-22 Di>
>   :LOGBOOK:
>   - State "DONE"       from "TODO"       [2011-12-17 Sa 21:42] \\
>     erledigt
>   :END:
> ***************************** END
>
> is it right to do so?  I thought planning info lines go right
> below the headline?

This is fixed. Thank you.

Regards,

-- 
Nicolas Goaziou

Re: org-lint complains about incorrect contents for PROPERTIES drawer in inline task

[Nicolas Goaziou]

Hello,

Gregor Zattler <telegraph@gmx.net> writes:

> I fixed another org-mode file and there is another strange
> behaviour of org-lint:
>
> org-lint complains:
>   9846 high  Incorrect contents for PROPERTIES drawer
>
> because of this:
>
> ***************************** watermelon watermelon watermelon
>       :PROPERTIES:
>       :CREATED: <2013-07-10 Mi 16:40>
>       :END:
>       <2013-07-11 Do>
> ***************************** END
>
> In order to fix it I recreated this inline task (C-c C-x t) and
> its PROPERTIES drawer (C-u M-x org-insert-drawer) and the
> specified property (C-c C-x p).  Org-lint complains nonetheless.

It should also be fixed along with the previous bug. Thank you.

Regards,

-- 
Nicolas Goaziou

fix confirmed (was: Re: org-lint complains about incorrect contents for PROPERTIES drawer in inline task)

[Gregor Zattler]

Hi Nicolas,

thanks, confirmed for both problems.

Thank you for your fast fix.

Empty *org-lint* buffers give a feeling of security :-)

Ciao; Gregor 

* Nicolas Goaziou <mail@nicolasgoaziou.fr> [16. Oct. 2015]:
> Gregor Zattler <telegraph@gmx.net> writes:
> 
>> I fixed another org-mode file and there is another strange
>> behaviour of org-lint:
>>
>> org-lint complains:
>>   9846 high  Incorrect contents for PROPERTIES drawer
>>
>> because of this:
>>
>> ***************************** watermelon watermelon watermelon
>>       :PROPERTIES:
>>       :CREATED: <2013-07-10 Mi 16:40>
>>       :END:
>>       <2013-07-11 Do>
>> ***************************** END
>>
>> In order to fix it I recreated this inline task (C-c C-x t) and
>> its PROPERTIES drawer (C-u M-x org-insert-drawer) and the
>> specified property (C-c C-x p).  Org-lint complains nonetheless.
> 
> It should also be fixed along with the previous bug. Thank you.
> 
> Regards,
> 
> -- 
> Nicolas Goaziou
> 
> 

Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-