GNU ELPA - wisi


Utilities for implementing an indentation/navigation engine using a generalized LALR parser
wisi-3.1.3.tar, 2020-Jun-07, 2.31 MiB
Stephen Leake <>
Home page
Browse ELPA's repository
CGit or Gitweb

To install this package, run in Emacs:

M-x package-install RET wisi RET

Full description

Emacs wisi package 3.1.2

The wisi package provides utilities for using generalized
error-correcting LR parsers (in external processes) to do indentation,
fontification, and navigation; and integration with Emacs package.el.
See ada-mode for an example of its use.

It also provides wisitoken-parse_table-mode, for navigating the
diagnostic parse tables output by wisitoken-bnf-generate.

The generated code is in Ada; it requires the AdaCore gnat compiler
that you may not have installed. It is available in many packaging
systems, or as a binary download from

Old versions

wisi-3.1.2.tar2020-Jun-052.30 MiB
wisi-3.1.1.tar2020-May-142.20 MiB
wisi-3.1.0.tar2020-May-142.20 MiB
wisi-3.0.1.tar2020-Jan-312.06 MiB
wisi-2.2.1.tar2019-Aug-181.98 MiB
wisi-2.2.0.tar2019-Aug-171.98 MiB
wisi-2.1.1.tar2019-Jul-121.91 MiB
wisi-2.1.0.tar2019-Mar-221.60 MiB
wisi-2.0.1.tar2018-Dec-081.55 MiB
wisi-2.0.0.tar2018-Dec-031.58 MiB
wisi-1.1.6.tar2017-Oct-03 110 KiB
wisi-1.1.5.tar2017-Jul-09 100 KiB
wisi-1.1.4.tar2016-Oct-31 100 KiB
wisi-1.1.3.tar2016-Jul-27 100 KiB
wisi-1.1.2.tar2016-Jan-22 100 KiB
wisi-1.1.1.tar2015-Apr-13 100 KiB
wisi-1.1.0.tar2014-Nov-27 100 KiB
wisi-1.0.6.tar2014-Sep-2990.0 KiB
wisi-1.0.5.tar2014-Jul-1980.0 KiB
wisi-1.0.4.tar2014-Apr-2080.0 KiB
wisi-1.0.2.tar2014-Mar-1570.0 KiB
wisi-1.0.1.tar2014-Mar-1470.0 KiB
wisi-1.0.tar2013-Dec-2570.0 KiB


GNU Emacs wisi NEWS -- history of user-visible changes.

Copyright (C) 2014 - 2020 Free Software Foundation, Inc.

Please send wisi bug reports to, with
'wisi' in the subject. If possible, use M-x report-emacs-bug.

* wisi 3.1.2
4 Jun 2020

** New dispatching function wisi-xref-completion-delim-regex for
   setting completion delimiters; example use in gpr-query.el.

** wisi-get-identifier (used by wisi-goto-spec/body and others) sets
   completion delimiters using wisi-xref-completion-delim-regex.

** A bug in wisi-before-change is fixed; it was missing many buffer
   changes, causing the parser not to be run when it should be.

* wisi 3.1.1
14 May 2020

** packaging bug fix

* wisi 3.1.0
11 May 2020

** Add Wisitoken.Syntax_Trees.Insert_Token, to allow using inserted
   virtual terminals tokens in indent. Several related changes to
   allow treating virtual terminals on par with actual terminals.

** New elisp generic functions: wisi-xref-completion-table, wisi-xref-completion-regexp, wisi-xref-completion-at-point-table

** New elisp functions: wisi-filter-table, wisi-completion-at-point, wisi-skel-add-token-after

** wisi-get-identifier uses wisi-xref-completion-table.

** wisi-prj-identifier-at-point returns (IDENT START END)

** In augmented tokens are no stored only in the syntax
   tree; new functions Get_Aug_Token_Const_1, Get_Aug_Token_Const,
   Get_Aug_Token_Var provide access to them. Parse_Data_Type contains
   a reference to the shared Terminals.

* wisi 3.0.1
30 Jan 2020

** fix packaging bugs

** improve xref integration

* wisi 3.0.0
19 Dec 2019

** parser process protocol version 5

** Add project.el integration. See for more information.

** Move autocase functions from ada-mode to wisi.

** Replace most ada-mode function variables with dispatching on wisi-prj.

** New commands `wisi-goto-containing-statement-start', `wisi-indent-containing-statement'.

** Displayed parser errors are sorted in increasing error position.

* wisi 2.2.1
17 Aug 2019

** parser process protocol version 4

** fix packaging bugs

* wisi 2.2.0
13 Aug 2019

** parser process protocol version 3

** Support for the elisp parser and lexer is deleted; only the Ada
   process parser is supported.

** New user variable `wisi-indent-context-lines' specifies the minimum
   number of lines before point to include in a parse for indenting a
   single line. This gives better results when indenting in a nested
   'if then else', for example. The default value is 0; you must
   change it to see an effect.

** Error correction is faster by approximately 30%;
   %mckenzie_enqueue_limit can be raised accordingly.

** %mckenzie_enqueue_limit is now applied to the total of all parsers
    in recovery; previously, it was applied to each parser separately.
    Applying to the total gives a more consistent maximum user wait
    time for recovery, at the cost of not finding solutions when there
    are many parsers involved. You may want to increase
    %mckenzie_enqueue_limit for this as well.

** In the process parser, `wisi-statement-start' now sets 'containing'
   in all contained caches to the start token, if not set already;
   previously it only did this if the token was mentioned in the
   `wisi-statement-start' action. This makes `wisi-containing-action'

** `wisi-containing-action' is deleted.

** An argument of `wisi-motion-action' that is a vector may now
   provide only one token ID. That token ID is searched for in the
   containing token region, and the motion token chain starting at the
   first one found is included in the current right hand side motion
   token chain.

** The process parser supports a new parse command `wisi-refactor',
   which returns a new message "Edit". It is intended for performing
   syntax-guided refactoring of code statements.

* wisi 2.1.1
11 Jul 2019

** parser process protocol version 3

** User variable wisi-mckenzie-cost-limit is deleted; set
   wisi-mckenzie-enqueue-limit instead, it gives better results.

** `wisi-show-parse-errors' now shows errors in a dedicated window, so
   it will not be resized or reused.

** New grammar action `wisi-name-action'; sets a name that will be
   fontified. This replaces the previous 'name' navigate class.

** Support 'nil' as an indent argument; useful for the first token,
   whose indent is typically unknown. Indent functions that do not
   accumulate now only check for "nil", not "zero or nil".

** New file wisi-xref.el provides a completion table built from tokens
   marked by the new grammar action `wisi-name-action'.

** The process parser checks the parser process protocol version, to
   ensure the elisp code matches the process code.

** The process parser supports passing data to a language-specific
   elisp function, via the `language-action-table' field of the
   `wisi-process--parser' struct.

** New user option `wisi-parse-max-parallel' to set the number of
   parallel parsers used; Java needs more than Ada.

* wisi 2.1.0
21 Mar 2019

** parser process protocol version 2

** Add support for partial parsing; useful in very large files. Files
   larger than wisi-partial-parse-threshold (default 100_001) will be
   parsed partially.

** Miscellaneous speed-ups in the Ada code; 'pragma Inline', better use of Ada tasks.

** Better error correction in the Ada process parser; insert minimimal
  tokens to complete a statement/declaration before or after the error

* wisi 2.0.1
8 Dec 2018

** parser process protocol version 1

** Assign copyright in Ada files to FSF

** Update user guide, include it in elpa package

* wisi 2.0.0
17 Nov 2018

** Change indentation engine to compute indent directly in parser actions.

** Add error correcting external process parser.

** Factor out wisi-elisp-lexer.el from wisi.el, and
   ada-wisi-elisp-parse.el from ada-wisi.el. Move elisp grammar
   actions from wisi.el to wisi-elisp-parse.el; they are not used with
   the process parser.

** Add support for error corrections in parser; 'wisi-repair-error'
   can apply the corrections to the buffer text.

** Display marks in fringe at location of errors detected by
   background parser.

** include sources for wisitoken parser runtime, parser generator.

* wisi 1.1.6
3 Oct 2017

** wisi-forward-find-cache-token - new function.

** New minor-mode parse_table-mode helps navigating parse table
   listings output by 'wisi-generate -v 1'; useful when debugging

* wisi 1.1.5
9 Jul 2017

** wisi-indent-fallback allows setting the indent engine to use when
   the wisi engine fails.

** wisi-comment-indent now uses comment-column for comments following
   code on the same line.

** wisi-forward-statement-keyword tolerates end of buffer, and uses
   either cache-next or cache-end.

** forward-sexp-function is set to wisi-forward-sexp, which handles
   parens, strings, and statements.

* wisi 1.1.4
31 Oct 2016

** wisi-validate-cache takes optional error-on-fail arg.

* wisi 1.1.3
26 Jul 2016

** improve use of quotes in doc strings.

* wisi 1.1.2
20 Jan 2016

** wisi-compile no longer requires semantic.

** wisi-parse slightly faster

** minor bug fixes

** wisi-extend-action now takes two args (first last)

** wisi-face-action-1 optional arg no-override is replaced by override-no-error.

* wisi 1.1.1
10 Apr 2015

** rename wisi-font-lock-size-threshold to wisi-size-threshold, use
   for more things in ada-mode

* wisi 1.1.0
18 Nov 2014

** change wisi-forward-token to not return text; simpler, faster

** remove face from wisi-cache; set font-lock-face property directly.

** add support for numeric literal tokens.

** change wisi-*-action to take a vector of arguments; faster for
   external parser, catches more errors.

** add wisi-font-lock-size-threshold

* wisi 1.0.6
28 Sep 2014

** add face to wisi-cache

** wisi-before/after-change : improve checks for invalidate-cache

** wisi-motion-action takes class with each token-id

** new parse actions: wisi-extend-action, wisi-face-action

** new functions: wisi-goto-statement-start, -end.

** fix misc bugs

* wisi 1.0.5
12 Jul 2014

** wisi-parse-max-parallel-current - new variable for debugging slow parsing issues

** wisi-set-end - new algorithm giving significant speedup

* wisi 1.0.4
19 Apr 2014

** add support for GNAT Ada bracket hex character notation

* wisi 1.0.3
16 Mar 2014

** fix another packaging bug; forgot to add files to ELPA git!

* wisi 1.0.2
14 Mar 2014

** Emacs 24.2 supported, via cl-lib in Gnu ELPA

* wisi 1.0.1

** minor fixes for byte compiler warnings

* wisi 1.0
Feb 2 2014

** first release in ELPA