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