From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rainer M Krug Subject: Re: [RFC] Org linting library Date: Fri, 05 Jun 2015 12:51:54 +0200 Message-ID: References: <87a8y4fdmv.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:54252) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0pEN-0007dl-Pj for emacs-orgmode@gnu.org; Fri, 05 Jun 2015 06:52:09 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z0pEJ-0001WT-OS for emacs-orgmode@gnu.org; Fri, 05 Jun 2015 06:52:07 -0400 Received: from mail-wg0-f52.google.com ([74.125.82.52]:35917) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z0pEJ-0001VY-H4 for emacs-orgmode@gnu.org; Fri, 05 Jun 2015 06:52:03 -0400 Received: by wgbgq6 with SMTP id gq6so53758727wgb.3 for ; Fri, 05 Jun 2015 03:52:02 -0700 (PDT) Received: from Rainers-MacBook-Pro.local (arn78-1-88-186-171-7.fbx.proxad.net. [88.186.171.7]) by mx.google.com with ESMTPSA id x10sm10023821wjf.45.2015.06.05.03.52.00 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 05 Jun 2015 03:52:00 -0700 (PDT) In-Reply-To: <87a8y4fdmv.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Sun, 19 Apr 2015 15:31:36 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Org Mode List --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable One more observation: The link ,---- | [[file:__BOX__/Aerodynamic%20resistances.docx][file:./__BOX__/Aerodynamic= resistances.docx]] `---- causes the following warnings: ,---- | 9094 low Link to non-existent local file "__BOX__/Aerodynamic%20resis= tances.docx" | 9094 low Link to non-existent local file "./__BOX__/Aerodynamic" `---- although the file exists and the link works in org. Cheers, Rainer Nicolas Goaziou writes: > Hello, > > The following library implements linting for Org syntax. The sole public > function is `org-lint', which see. > > Internally, the library defines a new structure: `org-lint-checker', > with the following slots: > > - NAME: Unique check identifier, as a symbol. The check is done > calling the function `org-lint-NAME' with one mandatory argument, > the parse tree describing the current Org buffer. Such function > calls are wrapped within a `save-excursion' and point is always at > `point-min'. Its return value has to be an alist (POSITION MESSAGE) > when POSITION refer to the buffer position of the error, as an > integer, and MESSAGE is a strings describing the error. > > - DESCRIPTION: Summary about the check, as a string. > > - CATEGORIES: Categories relative to the check, as a list of symbol. > They are used for filtering when calling `org-lint'. Checkers not > explicitly associated to a category are collected in the `default' > one. > > - TRUST: The trust level one can have in the check. It is either `low' > or `high', depending on the heuristics implemented and the nature of > the check. This has an indicative value only and is displayed along > reports. > > All checks have to be listed in `org-lint--checkers'. > > Results are displayed in a special "*Org Lint*" buffer with a dedicated > major mode, derived from `tabulated-list-mode'. In addition to the usual > key-bindings inherited from it, "C-j" displays problematic line reported > under point and "RET" jumps to it. > > Checks currently implemented are: > > - duplicates CUSTOM_ID properties > - duplicate NAME values > - duplicate targets > - duplicate footnote definitions > - orphaned affiliated keywords > - obsolete affiliated keywords > - missing language in src blocks > - NAME values with a colon > - wrong header arguments in src blocks > - misuse of CATEGORY keyword > - "coderef" links with unknown destination > - "custom-id" links with unknown destination > - "fuzzy" links with unknown destination > - "id" links with unknown destination > - links to non-existent local files > - special properties in properties drawer > - obsolete syntax for PROPERTIES drawers > - missing definition for footnote references > - missing reference for footnote definitions > - non-footnote definitions in footnote section > - probable invalid keywords > - invalid blocks > - probable incomplete drawers > - obsolete QUOTE section > > Since it relies on lexical binding, `pcase' and `string-prefix-p', it > cannot be added to Org 8.3, but can make it into Org 8.4, if deemed > useful enough. > > Feedback welcome. > > > Regards, =2D-=20 Rainer M. Krug, PhD (Conservation Ecology, SUN), MSc (Conservation Biology,= UCT), Dipl. Phys. (Germany) Centre of Excellence for Invasion Biology Stellenbosch University South Africa Tel : +33 - (0)9 53 10 27 44 Cell: +33 - (0)6 85 62 59 98 Fax : +33 - (0)9 58 10 27 44 Fax (D): +49 - (0)3 21 21 25 22 44 email: Rainer@krugs.de Skype: RMkrug PGP: 0x0F52F982 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG/MacGPG2 v2.0.22 (Darwin) iQEcBAEBAgAGBQJVcX9OAAoJENvXNx4PUvmCieUH/2Xo1YBo/CkdSrPgYnpVMorc 5pVBYRDMLdsND2wLGJOnfxalb/Cklsyts67DU6h45MS4wynWB547jf5zXqt/jElZ ixdnOUHZ3kGpTmCL3Zm9ciWToxB0ukUNRiisKEOwA2DjDFpUh1k5nrytkQkj4bnE NQZ+ENNvV6iXWDuXEltPJFeiFm8iV1cvRt1gE0prEIWEU1DvO+WSlU73TrJB/gPt tenGGuWH2/quudICNVV1vWvQ4emUmXRsezI0TH+VJU3WsudPWsygs+k4MZSrC/QK 4W72xtiSmw3yV0B6cZt0QfHZGnKbY/Q2elx+RBkL4u2vxQftpPWkiDcU4X/tLnM= =XhXb -----END PGP SIGNATURE----- --=-=-=--