summaryrefslogtreecommitdiff
path: root/usr.bin/vi/perl_api/nviperl.pod
blob: 43850d8b6363460ca86e13fb9d70fc72c0846792 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
=head1 NAME

nviperl - nvi with embedded perl

=head1 SYNOPSIS

    :perl require 'wc.pl'
    :perl wc
    :,$perldo $_=reverse($_)

=head1 DESCRIPTION

nvi with embedded perl allows you to run perl commands from within nvi.
Two additional commands are made available when you enable the perl
interpreter:

=over 8

=item * perl cmd

The perl command passes the specified commands to the perl interpreter.
The C<$VI::ScreenId>, C<$VI::StartLine> and C<$VI::StopLine> are set.
To find out how to maniplulate the nvi screens, see L<VI>.

=item * perldo cmd

The perldo command runs the specified commands on each line of the range
(every line of the file if no range specified).  Before running the
command the line is copied into $_.  If the command returns a true value
the line is replaced by the new value of $_.

The perldo commando does B<not> set the C<VI> variables.  (If you think
this is a bad idea, tell me.)

=back

=head1 SEE ALSO

L<VI>

=head1 AUTHOR

Sven Verdoolaege <skimo@dns.ufsia.ac.be>