perl 3.0 patch #44 patch #42, continued
[p5sagit/p5-mst-13.2.git] / x2p / s2p.man
CommitLineData
8d063cd8 1.rn '' }`
a687059c 2''' $Header: s2p.man,v 3.0 89/10/18 15:35:09 lwall Locked $
8d063cd8 3'''
4''' $Log: s2p.man,v $
a687059c 5''' Revision 3.0 89/10/18 15:35:09 lwall
6''' 3.0 baseline
7'''
378cc40b 8''' Revision 2.0 88/06/05 00:15:59 root
9''' Baseline version 2.0.
8d063cd8 10'''
11'''
12.de Sh
13.br
14.ne 5
15.PP
16\fB\\$1\fR
17.PP
18..
19.de Sp
20.if t .sp .5v
21.if n .sp
22..
23.de Ip
24.br
25.ie \\n.$>=3 .ne \\$3
26.el .ne 3
27.IP "\\$1" \\$2
28..
29'''
30''' Set up \*(-- to give an unbreakable dash;
31''' string Tr holds user defined translation string.
32''' Bell System Logo is used as a dummy character.
33'''
378cc40b 34.tr \(*W-|\(bv\*(Tr
8d063cd8 35.ie n \{\
378cc40b 36.ds -- \(*W-
37.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
8d063cd8 39.ds L" ""
40.ds R" ""
41.ds L' '
42.ds R' '
43'br\}
44.el\{\
45.ds -- \(em\|
46.tr \*(Tr
47.ds L" ``
48.ds R" ''
49.ds L' `
50.ds R' '
51'br\}
52.TH S2P 1 NEW
53.SH NAME
54s2p - Sed to Perl translator
55.SH SYNOPSIS
56.B s2p [options] filename
57.SH DESCRIPTION
58.I S2p
59takes a sed script specified on the command line (or from standard input)
60and produces a comparable
61.I perl
62script on the standard output.
63.Sh "Options"
64Options include:
65.TP 5
66.B \-D<number>
67sets debugging flags.
68.TP 5
69.B \-n
70specifies that this sed script was always invoked with a sed -n.
71Otherwise a switch parser is prepended to the front of the script.
72.TP 5
73.B \-p
74specifies that this sed script was never invoked with a sed -n.
75Otherwise a switch parser is prepended to the front of the script.
76.Sh "Considerations"
77The perl script produced looks very sed-ish, and there may very well be
78better ways to express what you want to do in perl.
79For instance, s2p does not make any use of the split operator, but you might
80want to.
81.PP
82The perl script you end up with may be either faster or slower than the original
83sed script.
84If you're only interested in speed you'll just have to try it both ways.
85Of course, if you want to do something sed doesn't do, you have no choice.
86.SH ENVIRONMENT
87S2p uses no environment variables.
88.SH AUTHOR
89Larry Wall <lwall@jpl-devvax.Jpl.Nasa.Gov>
90.SH FILES
91.SH SEE ALSO
92perl The perl compiler/interpreter
93.br
94a2p awk to perl translator
95.SH DIAGNOSTICS
96.SH BUGS
97.rn }` ''