Debian Codegraph @

upstream/mageia-cauldron/man3pm/B::Terse.3pm

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "B::Terse 3pm"
61 .TH B::Terse 3pm 2023-12-22 "perl v5.42.0" "Perl Programmers Reference Guide"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 B::Terse \- Walk Perl syntax tree, printing terse info about ops
68 .SH SYNOPSIS
69 .IX Header "SYNOPSIS"
70 .Vb 1
71 \& perl \-MO=Terse[,OPTIONS] foo.pl
72 .Ve
73 .SH DESCRIPTION
74 .IX Header "DESCRIPTION"
75 This module prints the contents of the parse tree, but without as much
76 information as CPAN module B::Debug. For comparison, \f(CW\*(C`print "Hello, world."\*(C'\fR
77 produced 96 lines of output from B::Debug, but only 6 from B::Terse.
78 .PP
79 This module is useful for people who are writing their own back end,
80 or who are learning about the Perl internals. It\*(Aqs not useful to the
81 average programmer.
82 .PP
83 This version of B::Terse is really just a wrapper that calls B::Concise
84 with the \fB\-terse\fR option. It is provided for compatibility with old scripts
85 (and habits) but using B::Concise directly is now recommended instead.
86 .PP
87 For compatibility with the old B::Terse, this module also adds a
88 method named \f(CW\*(C`terse\*(C'\fR to B::OP and B::SV objects. The B::SV method is
89 largely compatible with the old one, though authors of new software
90 might be advised to choose a more user\-friendly output format. The
91 B::OP \f(CW\*(C`terse\*(C'\fR method, however, doesn\*(Aqt work well. Since B::Terse was
92 first written, much more information in OPs has migrated to the
93 scratchpad datastructure, but the \f(CW\*(C`terse\*(C'\fR interface doesn\*(Aqt have any
94 way of getting to the correct pad. As a kludge, the new version will
95 always use the pad for the main program, but for OPs in subroutines
96 this will give the wrong answer or crash.
97 .SH AUTHOR
98 .IX Header "AUTHOR"
99 The original version of B::Terse was written by Malcolm Beattie,
100 <[email protected]>. This wrapper was written by Stephen
101 McCamant, <[email protected]>.