xref: /netbsd-src/external/bsd/nvi/dist/perl_api/nviperl.pod (revision dbd550ed1a6686d6600f748306f9cc03d8cd4c94)
1*dbd550edSchristos=head1 NAME
2*dbd550edSchristos
3*dbd550edSchristosnviperl - nvi with embedded perl
4*dbd550edSchristos
5*dbd550edSchristos=head1 SYNOPSIS
6*dbd550edSchristos
7*dbd550edSchristos    :perl require 'wc.pl'
8*dbd550edSchristos    :perl wc
9*dbd550edSchristos    :,$perldo $_=reverse($_)
10*dbd550edSchristos
11*dbd550edSchristos=head1 DESCRIPTION
12*dbd550edSchristos
13*dbd550edSchristosnvi with embedded perl allows you to run perl commands from within nvi.
14*dbd550edSchristosTwo additional commands are made available when you enable the perl
15*dbd550edSchristosinterpreter:
16*dbd550edSchristos
17*dbd550edSchristos=over 8
18*dbd550edSchristos
19*dbd550edSchristos=item * perl cmd
20*dbd550edSchristos
21*dbd550edSchristosThe perl command passes the specified commands to the perl interpreter.
22*dbd550edSchristosThe C<$VI::ScreenId>, C<$VI::StartLine> and C<$VI::StopLine> are set.
23*dbd550edSchristosTo find out how to maniplulate the nvi screens, see L<VI>.
24*dbd550edSchristos
25*dbd550edSchristos=item * perldo cmd
26*dbd550edSchristos
27*dbd550edSchristosThe perldo command runs the specified commands on each line of the range
28*dbd550edSchristos(every line of the file if no range specified).  Before running the
29*dbd550edSchristoscommand the line is copied into $_.  If the command returns a true value
30*dbd550edSchristosthe line is replaced by the new value of $_.
31*dbd550edSchristos
32*dbd550edSchristosThe perldo commando does B<not> set the C<VI> variables.  (If you think
33*dbd550edSchristosthis is a bad idea, tell me.)
34*dbd550edSchristos
35*dbd550edSchristos=back
36*dbd550edSchristos
37*dbd550edSchristos=head1 SEE ALSO
38*dbd550edSchristos
39*dbd550edSchristosL<VI>
40*dbd550edSchristos
41*dbd550edSchristos=head1 AUTHOR
42*dbd550edSchristos
43*dbd550edSchristosSven Verdoolaege <skimo@kotnet.org>
44