Repository navigation
Perl Features
| 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 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.
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.plFormatting 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=500This 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.
For example, save the file and run a check:
:w
:! perl -c path/to/saved-file.plOutput 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.
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.
pvim source · Downloads · Issues
Generated from source documentation for pvim 0.1.13. How these pages stay current.
pvim 0.1.13