Skip to content

Perl Features

Brett Estrade edited this page Nov 15, 2026 · 4 revisions

Perl-focused features and current limits

What exists now

Feature Current implementation Limits
Syntax highlighting Deferred; language lexer removed File text is plain; optional yellow number gutter remains
Perltidy \t (backslash then t), :pt, :perltidy Optional Perl::Tidy for the same interpreter; whole-buffer, 8 MiB / 200,000-line cap
Search/substitution Host Perl regex engine; captures, &, g and i Not Vim regex syntax; line-oriented replacement; no evaluated replacement
External Perl tools :! command displays results; :.!, ranged !, %! filter text Tools must already be installed; explicit shell commands can have external effects
Command output insertion :r !command, :0r !command Command gets no buffer input; output is inserted as lines
Automation --batch and repeatable -c ex commands Supported ex subset; writes are explicit

There is no PPI/tree-sitter parser, language server, automatic completion, buffer-aware compiler checker, debugger, test-results panel or project navigation yet. Optional external tools can be invoked, but that is distinct from an integrated Perl IDE. The runtime still requires only the full standard Perl library.

Syntax highlighting is deferred

Syntax highlighting has been removed for now so it does not delay editing or releases. File text is rendered plainly, with no language lexer on the display path. :set syntax, :set nosyntax and --no-syntax are no longer options.

The explicitly requested yellow number gutter (:set number) and reverse-video status line remain as terminal UI styling. Line numbers are off by default. Highlighting may be revisited later; it is not a current feature or release blocker.

Perltidy

Type backslash followed by t in normal mode, or use :pt / :perltidy. The built-in integration loads Perl::Tidy from the same Perl interpreter as pvim. Merely having a perltidy executable for a different interpreter does not enable :pt. Ordinary editing works without the formatter.

Optional user-local installation with an existing cpanminus:

cpanm --local-lib "$HOME/perl5" Perl::Tidy
PERL5LIB="$HOME/perl5/lib/perl5${PERL5LIB:+:$PERL5LIB}" pvim file.pl

Formatting uses -npro -l=500, ignores perltidy profiles, forms one undo unit, and never saves automatically. Failure leaves the buffer unchanged. The built-in integration caps whole-buffer input at 8 MiB and 200,000 lines.

An installed executable can instead be called explicitly as a whole-file filter:

:%! perltidy -st -npro -l=500

This uses the executable on PATH, which may belong to another Perl. Its stdout replaces the whole buffer; its own memory requirements apply. Use u to undo.

Syntax checks and tests through the shell

For example, save the file and run a check:

:w
:! perl -c path/to/saved-file.pl

Output appears on the terminal; press Enter to return. The command checks the saved file, not unsaved buffer text. Spell the path explicitly: Vim-style % filename expansion inside commands is not implemented yet.

:! prove -l t can run a project's tests from the directory where pvim was launched. Ctrl-Z also suspends to the shell; fg resumes with the same buffer. Neither mechanism yet supplies clickable diagnostics or automatic error navigation.

Do not run :%! perl -c: a successful compiler check normally emits no source on stdout, so a filter would delete its input range. Use bare :! for execution. See Shell Commands and Filters for all three command forms.

Visual highlighting

Vim-style visual selection is not implemented: no v, V, blockwise Ctrl-V, selection highlight or selection operators. ANSI colors and the reverse-video status line provide display primitives; a real selection still needs an anchor, range tracking and copy/delete/change behavior.

Linewise V is the smallest useful first stage because line yank/delete and ranged filters already exist. Characterwise v would follow; blockwise selection is a larger task. These are proposed stages, not enabled features. See Vim Differences for the advanced-beginner feature shortlist.

Clone this wiki locally