Debian Codegraph @

upstream/debian-unstable/man3/ExtUtils::Miniperl.3perl

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (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 .\"
57 .IX Title "ExtUtils::Miniperl 3perl"
58 .TH ExtUtils::Miniperl 3perl 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 ExtUtils::Miniperl \- write the C code for miniperlmain.c and perlmain.c
65 .SH SYNOPSIS
66 .IX Header "SYNOPSIS"
67 .Vb 6
68 \& use ExtUtils::Miniperl;
69 \& writemain(@directories);
70 \& # or
71 \& writemain($fh, @directories);
72 \& # or
73 \& writemain(\e$filename, @directories);
74 .Ve
75 .SH DESCRIPTION
76 .IX Header "DESCRIPTION"
77 \&\f(CWwritemain()\fR takes an argument list of zero or more directories
78 containing archive
79 libraries that relate to perl modules and should be linked into a new
80 perl binary. It writes a corresponding \fIminiperlmain.c\fR or \fIperlmain.c\fR
81 file that
82 is a plain C file containing all the bootstrap code to make the
83 modules associated with the libraries available from within perl.
84 If the first argument to \f(CWwritemain()\fR is a reference to a scalar it is
85 used as the filename to open for output. Any other reference is used as
86 the filehandle to write to. Otherwise output defaults to \f(CW\*(C`STDOUT\*(C'\fR.
87 .PP
88 The typical usage is from within perl's own Makefile (to build
89 \&\fIperlmain.c\fR) or from \fIregen/miniperlmain.pl\fR (to build miniperlmain.c).
90 So under normal circumstances you won't have to deal with this module
91 directly.
92 .SH "SEE ALSO"
93 .IX Header "SEE ALSO"
94 ExtUtils::MakeMaker