Add built local::lib
[catagits/Gitalist.git] / local-lib5 / man / man3 / Devel::PPPort.3pm
1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sh \" Subsection heading
6 .br
7 .if t .Sp
8 .ne 5
9 .PP
10 \fB\\$1\fR
11 .PP
12 ..
13 .de Sp \" Vertical space (when we can't use .PP)
14 .if t .sp .5v
15 .if n .sp
16 ..
17 .de Vb \" Begin verbatim text
18 .ft CW
19 .nf
20 .ne \\$1
21 ..
22 .de Ve \" End verbatim text
23 .ft R
24 .fi
25 ..
26 .\" Set up some character translations and predefined strings.  \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote.  | will give a
29 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
30 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
32 .tr \(*W-|\(bv\*(Tr
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34 .ie n \{\
35 .    ds -- \(*W-
36 .    ds PI pi
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
39 .    ds L" ""
40 .    ds R" ""
41 .    ds C` ""
42 .    ds C' ""
43 'br\}
44 .el\{\
45 .    ds -- \|\(em\|
46 .    ds PI \(*p
47 .    ds L" ``
48 .    ds R" ''
49 'br\}
50 .\"
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD.  Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
55 .if \nF \{\
56 .    de IX
57 .    tm Index:\\$1\t\\n%\t"\\$2"
58 ..
59 .    nr % 0
60 .    rr F
61 .\}
62 .\"
63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
65 .hy 0
66 .if n .na
67 .\"
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
70 .    \" fudge factors for nroff and troff
71 .if n \{\
72 .    ds #H 0
73 .    ds #V .8m
74 .    ds #F .3m
75 .    ds #[ \f1
76 .    ds #] \fP
77 .\}
78 .if t \{\
79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80 .    ds #V .6m
81 .    ds #F 0
82 .    ds #[ \&
83 .    ds #] \&
84 .\}
85 .    \" simple accents for nroff and troff
86 .if n \{\
87 .    ds ' \&
88 .    ds ` \&
89 .    ds ^ \&
90 .    ds , \&
91 .    ds ~ ~
92 .    ds /
93 .\}
94 .if t \{\
95 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
101 .\}
102 .    \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 .    \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 .    \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
117 \{\
118 .    ds : e
119 .    ds 8 ss
120 .    ds o a
121 .    ds d- d\h'-1'\(ga
122 .    ds D- D\h'-1'\(hy
123 .    ds th \o'bp'
124 .    ds Th \o'LP'
125 .    ds ae ae
126 .    ds Ae AE
127 .\}
128 .rm #[ #] #H #V #F C
129 .\" ========================================================================
130 .\"
131 .IX Title "PPPort 3"
132 .TH PPPort 3 "2009-06-14" "perl v5.8.7" "User Contributed Perl Documentation"
133 .SH "NAME"
134 Devel::PPPort \- Perl/Pollution/Portability
135 .SH "SYNOPSIS"
136 .IX Header "SYNOPSIS"
137 .Vb 2
138 \&    Devel::PPPort::WriteFile();   # defaults to ./ppport.h
139 \&    Devel::PPPort::WriteFile('someheader.h');
140 .Ve
141 .SH "DESCRIPTION"
142 .IX Header "DESCRIPTION"
143 Perl's \s-1API\s0 has changed over time, gaining new features, new functions,
144 increasing its flexibility, and reducing the impact on the C namespace
145 environment (reduced pollution). The header file written by this module,
146 typically \fIppport.h\fR, attempts to bring some of the newer Perl \s-1API\s0
147 features to older versions of Perl, so that you can worry less about
148 keeping track of old releases, but users can still reap the benefit.
149 .PP
150 \&\f(CW\*(C`Devel::PPPort\*(C'\fR contains a single function, called \f(CW\*(C`WriteFile\*(C'\fR. Its
151 only purpose is to write the \fIppport.h\fR C header file. This file
152 contains a series of macros and, if explicitly requested, functions that
153 allow \s-1XS\s0 modules to be built using older versions of Perl. Currently,
154 Perl versions from 5.003 to 5.10.0 are supported.
155 .PP
156 This module is used by \f(CW\*(C`h2xs\*(C'\fR to write the file \fIppport.h\fR.
157 .Sh "Why use ppport.h?"
158 .IX Subsection "Why use ppport.h?"
159 You should use \fIppport.h\fR in modern code so that your code will work
160 with the widest range of Perl interpreters possible, without significant
161 additional work.
162 .PP
163 You should attempt older code to fully use \fIppport.h\fR, because the
164 reduced pollution of newer Perl versions is an important thing. It's so
165 important that the old polluting ways of original Perl modules will not be
166 supported very far into the future, and your module will almost certainly
167 break! By adapting to it now, you'll gain compatibility and a sense of
168 having done the electronic ecology some good.
169 .Sh "How to use ppport.h"
170 .IX Subsection "How to use ppport.h"
171 Don't direct the users of your module to download \f(CW\*(C`Devel::PPPort\*(C'\fR.
172 They are most probably no \s-1XS\s0 writers. Also, don't make \fIppport.h\fR
173 optional. Rather, just take the most recent copy of \fIppport.h\fR that
174 you can find (e.g. by generating it with the latest \f(CW\*(C`Devel::PPPort\*(C'\fR
175 release from \s-1CPAN\s0), copy it into your project, adjust your project to
176 use it, and distribute the header along with your module.
177 .Sh "Running ppport.h"
178 .IX Subsection "Running ppport.h"
179 But \fIppport.h\fR is more than just a C header. It's also a Perl script
180 that can check your source code. It will suggest hints and portability
181 notes, and can even make suggestions on how to change your code. You
182 can run it like any other Perl program:
183 .PP
184 .Vb 1
185 \&    perl ppport.h [options] [files]
186 .Ve
187 .PP
188 It also has embedded documentation, so you can use
189 .PP
190 .Vb 1
191 \&    perldoc ppport.h
192 .Ve
193 .PP
194 to find out more about how to use it.
195 .SH "FUNCTIONS"
196 .IX Header "FUNCTIONS"
197 .Sh "WriteFile"
198 .IX Subsection "WriteFile"
199 \&\f(CW\*(C`WriteFile\*(C'\fR takes one optional argument. When called with one
200 argument, it expects to be passed a filename. When called with
201 no arguments, it defaults to the filename \fIppport.h\fR.
202 .PP
203 The function returns a true value if the file was written successfully.
204 Otherwise it returns a false value.
205 .SH "COMPATIBILITY"
206 .IX Header "COMPATIBILITY"
207 \&\fIppport.h\fR supports Perl versions from 5.003 to 5.10.0
208 in threaded and non-threaded configurations.
209 .Sh "Provided Perl compatibility \s-1API\s0"
210 .IX Subsection "Provided Perl compatibility API"
211 The header file written by this module, typically \fIppport.h\fR, provides
212 access to the following elements of the Perl \s-1API\s0 that is not available
213 in older Perl releases:
214 .PP
215 .Vb 461
216 \&    _aMY_CXT
217 \&    _pMY_CXT
218 \&    aMY_CXT
219 \&    aMY_CXT_
220 \&    aTHX
221 \&    aTHX_
222 \&    aTHXR
223 \&    aTHXR_
224 \&    AvFILLp
225 \&    boolSV
226 \&    call_argv
227 \&    call_method
228 \&    call_pv
229 \&    call_sv
230 \&    ckWARN
231 \&    CopFILE
232 \&    CopFILE_set
233 \&    CopFILEAV
234 \&    CopFILEGV
235 \&    CopFILEGV_set
236 \&    CopFILESV
237 \&    CopSTASH
238 \&    CopSTASH_eq
239 \&    CopSTASH_set
240 \&    CopSTASHPV
241 \&    CopSTASHPV_set
242 \&    CopyD
243 \&    CPERLscope
244 \&    dAX
245 \&    dAXMARK
246 \&    DEFSV
247 \&    DEFSV_set
248 \&    dITEMS
249 \&    dMY_CXT
250 \&    dMY_CXT_SV
251 \&    dNOOP
252 \&    dTHR
253 \&    dTHX
254 \&    dTHXa
255 \&    dTHXoa
256 \&    dTHXR
257 \&    dUNDERBAR
258 \&    dVAR
259 \&    dXCPT
260 \&    dXSTARG
261 \&    END_EXTERN_C
262 \&    ERRSV
263 \&    eval_pv
264 \&    eval_sv
265 \&    EXTERN_C
266 \&    G_METHOD
267 \&    get_av
268 \&    get_cv
269 \&    get_hv
270 \&    get_sv
271 \&    grok_bin
272 \&    grok_hex
273 \&    grok_number
274 \&    GROK_NUMERIC_RADIX
275 \&    grok_numeric_radix
276 \&    grok_oct
277 \&    gv_fetchpvn_flags
278 \&    gv_fetchpvs
279 \&    gv_stashpvn
280 \&    gv_stashpvs
281 \&    GvSVn
282 \&    hv_fetchs
283 \&    hv_stores
284 \&    HvNAME_get
285 \&    HvNAMELEN_get
286 \&    IN_LOCALE
287 \&    IN_LOCALE_COMPILETIME
288 \&    IN_LOCALE_RUNTIME
289 \&    IN_PERL_COMPILETIME
290 \&    INT2PTR
291 \&    IS_NUMBER_GREATER_THAN_UV_MAX
292 \&    IS_NUMBER_IN_UV
293 \&    IS_NUMBER_INFINITY
294 \&    IS_NUMBER_NAN
295 \&    IS_NUMBER_NEG
296 \&    IS_NUMBER_NOT_INT
297 \&    isALNUMC
298 \&    isASCII
299 \&    isBLANK
300 \&    isCNTRL
301 \&    isGRAPH
302 \&    isGV_with_GP
303 \&    isPRINT
304 \&    isPSXSPC
305 \&    isPUNCT
306 \&    isXDIGIT
307 \&    IVdf
308 \&    IVSIZE
309 \&    IVTYPE
310 \&    load_module
311 \&    memEQ
312 \&    memNE
313 \&    MoveD
314 \&    mPUSHi
315 \&    mPUSHn
316 \&    mPUSHp
317 \&    mPUSHs
318 \&    mPUSHu
319 \&    mXPUSHi
320 \&    mXPUSHn
321 \&    mXPUSHp
322 \&    mXPUSHs
323 \&    mXPUSHu
324 \&    MY_CXT
325 \&    MY_CXT_CLONE
326 \&    MY_CXT_INIT
327 \&    my_snprintf
328 \&    my_sprintf
329 \&    my_strlcat
330 \&    my_strlcpy
331 \&    newCONSTSUB
332 \&    newRV_inc
333 \&    newRV_noinc
334 \&    newSV_type
335 \&    newSVpvn
336 \&    newSVpvn_flags
337 \&    newSVpvn_share
338 \&    newSVpvn_utf8
339 \&    newSVpvs
340 \&    newSVpvs_flags
341 \&    newSVuv
342 \&    Newx
343 \&    Newxc
344 \&    Newxz
345 \&    NOOP
346 \&    NUM2PTR
347 \&    NVef
348 \&    NVff
349 \&    NVgf
350 \&    NVTYPE
351 \&    packWARN
352 \&    PERL_ABS
353 \&    PERL_BCDVERSION
354 \&    PERL_GCC_BRACE_GROUPS_FORBIDDEN
355 \&    PERL_HASH
356 \&    PERL_INT_MAX
357 \&    PERL_INT_MIN
358 \&    PERL_LONG_MAX
359 \&    PERL_LONG_MIN
360 \&    PERL_MAGIC_arylen
361 \&    PERL_MAGIC_backref
362 \&    PERL_MAGIC_bm
363 \&    PERL_MAGIC_collxfrm
364 \&    PERL_MAGIC_dbfile
365 \&    PERL_MAGIC_dbline
366 \&    PERL_MAGIC_defelem
367 \&    PERL_MAGIC_env
368 \&    PERL_MAGIC_envelem
369 \&    PERL_MAGIC_ext
370 \&    PERL_MAGIC_fm
371 \&    PERL_MAGIC_glob
372 \&    PERL_MAGIC_isa
373 \&    PERL_MAGIC_isaelem
374 \&    PERL_MAGIC_mutex
375 \&    PERL_MAGIC_nkeys
376 \&    PERL_MAGIC_overload
377 \&    PERL_MAGIC_overload_elem
378 \&    PERL_MAGIC_overload_table
379 \&    PERL_MAGIC_pos
380 \&    PERL_MAGIC_qr
381 \&    PERL_MAGIC_regdata
382 \&    PERL_MAGIC_regdatum
383 \&    PERL_MAGIC_regex_global
384 \&    PERL_MAGIC_shared
385 \&    PERL_MAGIC_shared_scalar
386 \&    PERL_MAGIC_sig
387 \&    PERL_MAGIC_sigelem
388 \&    PERL_MAGIC_substr
389 \&    PERL_MAGIC_sv
390 \&    PERL_MAGIC_taint
391 \&    PERL_MAGIC_tied
392 \&    PERL_MAGIC_tiedelem
393 \&    PERL_MAGIC_tiedscalar
394 \&    PERL_MAGIC_utf8
395 \&    PERL_MAGIC_uvar
396 \&    PERL_MAGIC_uvar_elem
397 \&    PERL_MAGIC_vec
398 \&    PERL_MAGIC_vstring
399 \&    PERL_PV_ESCAPE_ALL
400 \&    PERL_PV_ESCAPE_FIRSTCHAR
401 \&    PERL_PV_ESCAPE_NOBACKSLASH
402 \&    PERL_PV_ESCAPE_NOCLEAR
403 \&    PERL_PV_ESCAPE_QUOTE
404 \&    PERL_PV_ESCAPE_RE
405 \&    PERL_PV_ESCAPE_UNI
406 \&    PERL_PV_ESCAPE_UNI_DETECT
407 \&    PERL_PV_PRETTY_DUMP
408 \&    PERL_PV_PRETTY_ELLIPSES
409 \&    PERL_PV_PRETTY_LTGT
410 \&    PERL_PV_PRETTY_NOCLEAR
411 \&    PERL_PV_PRETTY_QUOTE
412 \&    PERL_PV_PRETTY_REGPROP
413 \&    PERL_QUAD_MAX
414 \&    PERL_QUAD_MIN
415 \&    PERL_REVISION
416 \&    PERL_SCAN_ALLOW_UNDERSCORES
417 \&    PERL_SCAN_DISALLOW_PREFIX
418 \&    PERL_SCAN_GREATER_THAN_UV_MAX
419 \&    PERL_SCAN_SILENT_ILLDIGIT
420 \&    PERL_SHORT_MAX
421 \&    PERL_SHORT_MIN
422 \&    PERL_SIGNALS_UNSAFE_FLAG
423 \&    PERL_SUBVERSION
424 \&    PERL_UCHAR_MAX
425 \&    PERL_UCHAR_MIN
426 \&    PERL_UINT_MAX
427 \&    PERL_UINT_MIN
428 \&    PERL_ULONG_MAX
429 \&    PERL_ULONG_MIN
430 \&    PERL_UNUSED_ARG
431 \&    PERL_UNUSED_CONTEXT
432 \&    PERL_UNUSED_DECL
433 \&    PERL_UNUSED_VAR
434 \&    PERL_UQUAD_MAX
435 \&    PERL_UQUAD_MIN
436 \&    PERL_USE_GCC_BRACE_GROUPS
437 \&    PERL_USHORT_MAX
438 \&    PERL_USHORT_MIN
439 \&    PERL_VERSION
440 \&    Perl_warner
441 \&    Perl_warner_nocontext
442 \&    PERLIO_FUNCS_CAST
443 \&    PERLIO_FUNCS_DECL
444 \&    PL_bufend
445 \&    PL_bufptr
446 \&    PL_compiling
447 \&    PL_copline
448 \&    PL_curcop
449 \&    PL_curstash
450 \&    PL_DBsignal
451 \&    PL_DBsingle
452 \&    PL_DBsub
453 \&    PL_DBtrace
454 \&    PL_debstash
455 \&    PL_defgv
456 \&    PL_diehook
457 \&    PL_dirty
458 \&    PL_dowarn
459 \&    PL_errgv
460 \&    PL_error_count
461 \&    PL_expect
462 \&    PL_hexdigit
463 \&    PL_hints
464 \&    PL_in_my
465 \&    PL_in_my_stash
466 \&    PL_laststatval
467 \&    PL_lex_state
468 \&    PL_lex_stuff
469 \&    PL_linestr
470 \&    PL_na
471 \&    PL_no_modify
472 \&    PL_parser
473 \&    PL_perl_destruct_level
474 \&    PL_perldb
475 \&    PL_ppaddr
476 \&    PL_rsfp
477 \&    PL_rsfp_filters
478 \&    PL_signals
479 \&    PL_stack_base
480 \&    PL_stack_sp
481 \&    PL_statcache
482 \&    PL_stdingv
483 \&    PL_Sv
484 \&    PL_sv_arenaroot
485 \&    PL_sv_no
486 \&    PL_sv_undef
487 \&    PL_sv_yes
488 \&    PL_tainted
489 \&    PL_tainting
490 \&    PL_tokenbuf
491 \&    pMY_CXT
492 \&    pMY_CXT_
493 \&    Poison
494 \&    PoisonFree
495 \&    PoisonNew
496 \&    PoisonWith
497 \&    pTHX
498 \&    pTHX_
499 \&    PTR2IV
500 \&    PTR2nat
501 \&    PTR2NV
502 \&    PTR2ul
503 \&    PTR2UV
504 \&    PTRV
505 \&    PUSHmortal
506 \&    PUSHu
507 \&    pv_display
508 \&    pv_escape
509 \&    pv_pretty
510 \&    SAVE_DEFSV
511 \&    START_EXTERN_C
512 \&    START_MY_CXT
513 \&    STMT_END
514 \&    STMT_START
515 \&    STR_WITH_LEN
516 \&    sv_2pv_flags
517 \&    sv_2pv_nolen
518 \&    sv_2pvbyte
519 \&    sv_2pvbyte_nolen
520 \&    sv_2uv
521 \&    sv_catpv_mg
522 \&    sv_catpvf_mg
523 \&    sv_catpvf_mg_nocontext
524 \&    sv_catpvn_mg
525 \&    sv_catpvn_nomg
526 \&    sv_catpvs
527 \&    sv_catsv_mg
528 \&    sv_catsv_nomg
529 \&    SV_CONST_RETURN
530 \&    SV_COW_DROP_PV
531 \&    SV_COW_SHARED_HASH_KEYS
532 \&    SV_GMAGIC
533 \&    SV_HAS_TRAILING_NUL
534 \&    SV_IMMEDIATE_UNREF
535 \&    sv_magic_portable
536 \&    SV_MUTABLE_RETURN
537 \&    SV_NOSTEAL
538 \&    sv_pvn_force_flags
539 \&    sv_pvn_nomg
540 \&    sv_setiv_mg
541 \&    sv_setnv_mg
542 \&    sv_setpv_mg
543 \&    sv_setpvf_mg
544 \&    sv_setpvf_mg_nocontext
545 \&    sv_setpvn_mg
546 \&    sv_setpvs
547 \&    sv_setsv_mg
548 \&    sv_setsv_nomg
549 \&    sv_setuv
550 \&    sv_setuv_mg
551 \&    SV_SMAGIC
552 \&    sv_usepvn_mg
553 \&    SV_UTF8_NO_ENCODING
554 \&    sv_uv
555 \&    sv_vcatpvf
556 \&    sv_vcatpvf_mg
557 \&    sv_vsetpvf
558 \&    sv_vsetpvf_mg
559 \&    SVf
560 \&    SVf_UTF8
561 \&    SVfARG
562 \&    SvGETMAGIC
563 \&    SvIV_nomg
564 \&    SvMAGIC_set
565 \&    SvPV_const
566 \&    SvPV_flags
567 \&    SvPV_flags_const
568 \&    SvPV_flags_const_nolen
569 \&    SvPV_flags_mutable
570 \&    SvPV_force
571 \&    SvPV_force_flags
572 \&    SvPV_force_flags_mutable
573 \&    SvPV_force_flags_nolen
574 \&    SvPV_force_mutable
575 \&    SvPV_force_nolen
576 \&    SvPV_force_nomg
577 \&    SvPV_force_nomg_nolen
578 \&    SvPV_mutable
579 \&    SvPV_nolen
580 \&    SvPV_nolen_const
581 \&    SvPV_nomg
582 \&    SvPV_nomg_const
583 \&    SvPV_nomg_const_nolen
584 \&    SvPV_renew
585 \&    SvPVbyte
586 \&    SvPVX_const
587 \&    SvPVX_mutable
588 \&    SvREFCNT_inc
589 \&    SvREFCNT_inc_NN
590 \&    SvREFCNT_inc_simple
591 \&    SvREFCNT_inc_simple_NN
592 \&    SvREFCNT_inc_simple_void
593 \&    SvREFCNT_inc_simple_void_NN
594 \&    SvREFCNT_inc_void
595 \&    SvREFCNT_inc_void_NN
596 \&    SvRV_set
597 \&    SvSHARED_HASH
598 \&    SvSTASH_set
599 \&    SvUOK
600 \&    SvUV
601 \&    SvUV_nomg
602 \&    SvUV_set
603 \&    SvUVX
604 \&    SvUVx
605 \&    SvUVXx
606 \&    SvVSTRING_mg
607 \&    UNDERBAR
608 \&    UTF8_MAXBYTES
609 \&    UVof
610 \&    UVSIZE
611 \&    UVTYPE
612 \&    UVuf
613 \&    UVXf
614 \&    UVxf
615 \&    vload_module
616 \&    vnewSVpvf
617 \&    WARN_ALL
618 \&    WARN_AMBIGUOUS
619 \&    WARN_ASSERTIONS
620 \&    WARN_BAREWORD
621 \&    WARN_CLOSED
622 \&    WARN_CLOSURE
623 \&    WARN_DEBUGGING
624 \&    WARN_DEPRECATED
625 \&    WARN_DIGIT
626 \&    WARN_EXEC
627 \&    WARN_EXITING
628 \&    WARN_GLOB
629 \&    WARN_INPLACE
630 \&    WARN_INTERNAL
631 \&    WARN_IO
632 \&    WARN_LAYER
633 \&    WARN_MALLOC
634 \&    WARN_MISC
635 \&    WARN_NEWLINE
636 \&    WARN_NUMERIC
637 \&    WARN_ONCE
638 \&    WARN_OVERFLOW
639 \&    WARN_PACK
640 \&    WARN_PARENTHESIS
641 \&    WARN_PIPE
642 \&    WARN_PORTABLE
643 \&    WARN_PRECEDENCE
644 \&    WARN_PRINTF
645 \&    WARN_PROTOTYPE
646 \&    WARN_QW
647 \&    WARN_RECURSION
648 \&    WARN_REDEFINE
649 \&    WARN_REGEXP
650 \&    WARN_RESERVED
651 \&    WARN_SEMICOLON
652 \&    WARN_SEVERE
653 \&    WARN_SIGNAL
654 \&    WARN_SUBSTR
655 \&    WARN_SYNTAX
656 \&    WARN_TAINT
657 \&    WARN_THREADS
658 \&    WARN_UNINITIALIZED
659 \&    WARN_UNOPENED
660 \&    WARN_UNPACK
661 \&    WARN_UNTIE
662 \&    WARN_UTF8
663 \&    WARN_VOID
664 \&    warner
665 \&    XCPT_CATCH
666 \&    XCPT_RETHROW
667 \&    XCPT_TRY_END
668 \&    XCPT_TRY_START
669 \&    XPUSHmortal
670 \&    XPUSHu
671 \&    XSprePUSH
672 \&    XSPROTO
673 \&    XSRETURN
674 \&    XSRETURN_UV
675 \&    XST_mUV
676 \&    ZeroD
677 .Ve
678 .Sh "Perl \s-1API\s0 not supported by ppport.h"
679 .IX Subsection "Perl API not supported by ppport.h"
680 There is still a big part of the \s-1API\s0 not supported by \fIppport.h\fR.
681 Either because it doesn't make sense to back-port that part of the \s-1API\s0,
682 or simply because it hasn't been implemented yet. Patches welcome!
683 .PP
684 Here's a list of the currently unsupported \s-1API\s0, and also the version of
685 Perl below which it is unsupported:
686 .IP "perl 5.11.0" 4
687 .IX Item "perl 5.11.0"
688 .Vb 26
689 \&  HeUTF8
690 \&  MULTICALL
691 \&  PERL_SYS_TERM
692 \&  POP_MULTICALL
693 \&  PUSH_MULTICALL
694 \&  SvOOK_offset
695 \&  av_iter_p
696 \&  croak_xs_usage
697 \&  fetch_cop_label
698 \&  gv_fetchmethod_flags
699 \&  hv_assert
700 \&  mro_get_from_name
701 \&  mro_get_private_data
702 \&  mro_register
703 \&  mro_set_mro
704 \&  mro_set_private_data
705 \&  pad_sv
706 \&  pregfree2
707 \&  ref
708 \&  save_adelete
709 \&  save_helem_flags
710 \&  save_padsv_and_mortalize
711 \&  save_pushptr
712 \&  stashpv_hvname_match
713 \&  sv_insert_flags
714 \&  sv_utf8_upgrade_flags_grow
715 .Ve
716 .IP "perl 5.10.0" 4
717 .IX Item "perl 5.10.0"
718 .Vb 6
719 \&  hv_common
720 \&  hv_common_key_len
721 \&  sv_destroyable
722 \&  sys_init
723 \&  sys_init3
724 \&  sys_term
725 .Ve
726 .IP "perl 5.9.5" 4
727 .IX Item "perl 5.9.5"
728 .Vb 29
729 \&  Perl_signbit
730 \&  SvRX
731 \&  SvRXOK
732 \&  av_create_and_push
733 \&  av_create_and_unshift_one
734 \&  get_cvn_flags
735 \&  gv_fetchfile_flags
736 \&  mro_get_linear_isa
737 \&  mro_method_changed_in
738 \&  my_dirfd
739 \&  pregcomp
740 \&  ptr_table_clear
741 \&  ptr_table_fetch
742 \&  ptr_table_free
743 \&  ptr_table_new
744 \&  ptr_table_split
745 \&  ptr_table_store
746 \&  re_compile
747 \&  re_intuit_start
748 \&  reg_named_buff_all
749 \&  reg_named_buff_exists
750 \&  reg_named_buff_fetch
751 \&  reg_named_buff_firstkey
752 \&  reg_named_buff_nextkey
753 \&  reg_named_buff_scalar
754 \&  regfree_internal
755 \&  savesharedpvn
756 \&  scan_vstring
757 \&  upg_version
758 .Ve
759 .IP "perl 5.9.4" 4
760 .IX Item "perl 5.9.4"
761 .Vb 7
762 \&  PerlIO_context_layers
763 \&  gv_name_set
764 \&  my_vsnprintf
765 \&  newXS_flags
766 \&  regclass_swash
767 \&  sv_does
768 \&  sv_usepvn_flags
769 .Ve
770 .IP "perl 5.9.3" 4
771 .IX Item "perl 5.9.3"
772 .Vb 24
773 \&  av_arylen_p
774 \&  ckwarn
775 \&  ckwarn_d
776 \&  csighandler
777 \&  dMULTICALL
778 \&  doref
779 \&  gv_const_sv
780 \&  hv_eiter_p
781 \&  hv_eiter_set
782 \&  hv_name_set
783 \&  hv_placeholders_get
784 \&  hv_placeholders_p
785 \&  hv_placeholders_set
786 \&  hv_riter_p
787 \&  hv_riter_set
788 \&  is_utf8_string_loclen
789 \&  newGIVENOP
790 \&  newSVhek
791 \&  newSVpvs_share
792 \&  newWHENOP
793 \&  newWHILEOP
794 \&  savepvs
795 \&  sortsv_flags
796 \&  vverify
797 .Ve
798 .IP "perl 5.9.2" 4
799 .IX Item "perl 5.9.2"
800 .Vb 7
801 \&  SvPVbyte_force
802 \&  find_rundefsvoffset
803 \&  gv_fetchsv
804 \&  op_refcnt_lock
805 \&  op_refcnt_unlock
806 \&  savesvpv
807 \&  vnormal
808 .Ve
809 .IP "perl 5.9.1" 4
810 .IX Item "perl 5.9.1"
811 .Vb 5
812 \&  hv_clear_placeholders
813 \&  hv_scalar
814 \&  scan_version
815 \&  sv_2iv_flags
816 \&  sv_2uv_flags
817 .Ve
818 .IP "perl 5.9.0" 4
819 .IX Item "perl 5.9.0"
820 .Vb 5
821 \&  new_version
822 \&  save_set_svflags
823 \&  vcmp
824 \&  vnumify
825 \&  vstringify
826 .Ve
827 .IP "perl 5.8.3" 4
828 .IX Item "perl 5.8.3"
829 .Vb 2
830 \&  SvIsCOW
831 \&  SvIsCOW_shared_hash
832 .Ve
833 .IP "perl 5.8.1" 4
834 .IX Item "perl 5.8.1"
835 .Vb 13
836 \&  SvVOK
837 \&  doing_taint
838 \&  find_runcv
839 \&  is_utf8_string_loc
840 \&  packlist
841 \&  save_bool
842 \&  savestack_grow_cnt
843 \&  seed
844 \&  sv_cat_decode
845 \&  sv_compile_2op
846 \&  sv_setpviv
847 \&  sv_setpviv_mg
848 \&  unpackstring
849 .Ve
850 .IP "perl 5.8.0" 4
851 .IX Item "perl 5.8.0"
852 .Vb 4
853 \&  hv_iternext_flags
854 \&  hv_store_flags
855 \&  is_utf8_idcont
856 \&  nothreadhook
857 .Ve
858 .IP "perl 5.7.3" 4
859 .IX Item "perl 5.7.3"
860 .Vb 61
861 \&  PerlIO_clearerr
862 \&  PerlIO_close
863 \&  PerlIO_eof
864 \&  PerlIO_error
865 \&  PerlIO_fileno
866 \&  PerlIO_fill
867 \&  PerlIO_flush
868 \&  PerlIO_get_base
869 \&  PerlIO_get_bufsiz
870 \&  PerlIO_get_cnt
871 \&  PerlIO_get_ptr
872 \&  PerlIO_read
873 \&  PerlIO_seek
874 \&  PerlIO_set_cnt
875 \&  PerlIO_set_ptrcnt
876 \&  PerlIO_setlinebuf
877 \&  PerlIO_stderr
878 \&  PerlIO_stdin
879 \&  PerlIO_stdout
880 \&  PerlIO_tell
881 \&  PerlIO_unread
882 \&  PerlIO_write
883 \&  SvLOCK
884 \&  SvSHARE
885 \&  SvUNLOCK
886 \&  atfork_lock
887 \&  atfork_unlock
888 \&  custom_op_desc
889 \&  custom_op_name
890 \&  deb
891 \&  debstack
892 \&  debstackptrs
893 \&  gv_fetchmeth_autoload
894 \&  ibcmp_utf8
895 \&  my_fork
896 \&  my_socketpair
897 \&  pack_cat
898 \&  perl_destruct
899 \&  pv_uni_display
900 \&  save_shared_pvref
901 \&  savesharedpv
902 \&  sortsv
903 \&  sv_copypv
904 \&  sv_magicext
905 \&  sv_nolocking
906 \&  sv_nosharing
907 \&  sv_recode_to_utf8
908 \&  sv_uni_display
909 \&  to_uni_fold
910 \&  to_uni_lower
911 \&  to_uni_title
912 \&  to_uni_upper
913 \&  to_utf8_case
914 \&  to_utf8_fold
915 \&  to_utf8_lower
916 \&  to_utf8_title
917 \&  to_utf8_upper
918 \&  unpack_str
919 \&  uvchr_to_utf8_flags
920 \&  uvuni_to_utf8_flags
921 \&  vdeb
922 .Ve
923 .IP "perl 5.7.2" 4
924 .IX Item "perl 5.7.2"
925 .Vb 16
926 \&  calloc
927 \&  getcwd_sv
928 \&  init_tm
929 \&  malloc
930 \&  mfree
931 \&  mini_mktime
932 \&  my_atof2
933 \&  my_strftime
934 \&  op_null
935 \&  realloc
936 \&  sv_catpvn_flags
937 \&  sv_catsv_flags
938 \&  sv_setsv_flags
939 \&  sv_utf8_upgrade_flags
940 \&  sv_utf8_upgrade_nomg
941 \&  swash_fetch
942 .Ve
943 .IP "perl 5.7.1" 4
944 .IX Item "perl 5.7.1"
945 .Vb 18
946 \&  POPpbytex
947 \&  bytes_from_utf8
948 \&  despatch_signals
949 \&  do_openn
950 \&  gv_handler
951 \&  is_lvalue_sub
952 \&  my_popen_list
953 \&  save_mortalizesv
954 \&  scan_num
955 \&  sv_force_normal_flags
956 \&  sv_setref_uv
957 \&  sv_unref_flags
958 \&  sv_utf8_upgrade
959 \&  utf8_length
960 \&  utf8_to_uvchr
961 \&  utf8_to_uvuni
962 \&  utf8n_to_uvuni
963 \&  uvuni_to_utf8
964 .Ve
965 .IP "perl 5.6.1" 4
966 .IX Item "perl 5.6.1"
967 .Vb 10
968 \&  SvGAMAGIC
969 \&  apply_attrs_string
970 \&  bytes_to_utf8
971 \&  gv_efullname4
972 \&  gv_fullname4
973 \&  is_utf8_string
974 \&  save_generic_pvref
975 \&  utf16_to_utf8
976 \&  utf16_to_utf8_reversed
977 \&  utf8_to_bytes
978 .Ve
979 .IP "perl 5.6.0" 4
980 .IX Item "perl 5.6.0"
981 .Vb 150
982 \&  PERL_SYS_INIT3
983 \&  SvIOK_UV
984 \&  SvIOK_notUV
985 \&  SvIOK_only_UV
986 \&  SvPOK_only_UTF8
987 \&  SvPVbyte_nolen
988 \&  SvPVbytex
989 \&  SvPVbytex_force
990 \&  SvPVutf8
991 \&  SvPVutf8_force
992 \&  SvPVutf8_nolen
993 \&  SvPVutf8x
994 \&  SvPVutf8x_force
995 \&  SvUOK
996 \&  SvUTF8
997 \&  SvUTF8_off
998 \&  SvUTF8_on
999 \&  av_delete
1000 \&  av_exists
1001 \&  call_atexit
1002 \&  cast_i32
1003 \&  cast_iv
1004 \&  cast_ulong
1005 \&  cast_uv
1006 \&  do_gv_dump
1007 \&  do_gvgv_dump
1008 \&  do_hv_dump
1009 \&  do_magic_dump
1010 \&  do_op_dump
1011 \&  do_open9
1012 \&  do_pmop_dump
1013 \&  do_sv_dump
1014 \&  dump_all
1015 \&  dump_eval
1016 \&  dump_form
1017 \&  dump_indent
1018 \&  dump_packsubs
1019 \&  dump_sub
1020 \&  dump_vindent
1021 \&  get_context
1022 \&  get_ppaddr
1023 \&  gv_dump
1024 \&  init_i18nl10n
1025 \&  init_i18nl14n
1026 \&  is_uni_alnum
1027 \&  is_uni_alnum_lc
1028 \&  is_uni_alnumc
1029 \&  is_uni_alnumc_lc
1030 \&  is_uni_alpha
1031 \&  is_uni_alpha_lc
1032 \&  is_uni_ascii
1033 \&  is_uni_ascii_lc
1034 \&  is_uni_cntrl
1035 \&  is_uni_cntrl_lc
1036 \&  is_uni_digit
1037 \&  is_uni_digit_lc
1038 \&  is_uni_graph
1039 \&  is_uni_graph_lc
1040 \&  is_uni_idfirst
1041 \&  is_uni_idfirst_lc
1042 \&  is_uni_lower
1043 \&  is_uni_lower_lc
1044 \&  is_uni_print
1045 \&  is_uni_print_lc
1046 \&  is_uni_punct
1047 \&  is_uni_punct_lc
1048 \&  is_uni_space
1049 \&  is_uni_space_lc
1050 \&  is_uni_upper
1051 \&  is_uni_upper_lc
1052 \&  is_uni_xdigit
1053 \&  is_uni_xdigit_lc
1054 \&  is_utf8_alnum
1055 \&  is_utf8_alnumc
1056 \&  is_utf8_alpha
1057 \&  is_utf8_ascii
1058 \&  is_utf8_char
1059 \&  is_utf8_cntrl
1060 \&  is_utf8_digit
1061 \&  is_utf8_graph
1062 \&  is_utf8_idfirst
1063 \&  is_utf8_lower
1064 \&  is_utf8_mark
1065 \&  is_utf8_print
1066 \&  is_utf8_punct
1067 \&  is_utf8_space
1068 \&  is_utf8_upper
1069 \&  is_utf8_xdigit
1070 \&  magic_dump
1071 \&  mess
1072 \&  my_atof
1073 \&  my_fflush_all
1074 \&  newANONATTRSUB
1075 \&  newATTRSUB
1076 \&  newXS
1077 \&  newXSproto
1078 \&  new_collate
1079 \&  new_ctype
1080 \&  new_numeric
1081 \&  op_dump
1082 \&  perl_parse
1083 \&  pmop_dump
1084 \&  re_intuit_string
1085 \&  reginitcolors
1086 \&  require_pv
1087 \&  safesyscalloc
1088 \&  safesysfree
1089 \&  safesysmalloc
1090 \&  safesysrealloc
1091 \&  save_I8
1092 \&  save_alloc
1093 \&  save_destructor
1094 \&  save_destructor_x
1095 \&  save_re_context
1096 \&  save_vptr
1097 \&  scan_bin
1098 \&  set_context
1099 \&  set_numeric_local
1100 \&  set_numeric_radix
1101 \&  set_numeric_standard
1102 \&  str_to_version
1103 \&  sv_2pvutf8
1104 \&  sv_2pvutf8_nolen
1105 \&  sv_force_normal
1106 \&  sv_len_utf8
1107 \&  sv_pos_b2u
1108 \&  sv_pos_u2b
1109 \&  sv_pv
1110 \&  sv_pvbyte
1111 \&  sv_pvbyten
1112 \&  sv_pvbyten_force
1113 \&  sv_pvutf8
1114 \&  sv_pvutf8n
1115 \&  sv_pvutf8n_force
1116 \&  sv_rvweaken
1117 \&  sv_utf8_decode
1118 \&  sv_utf8_downgrade
1119 \&  sv_utf8_encode
1120 \&  swash_init
1121 \&  tmps_grow
1122 \&  to_uni_lower_lc
1123 \&  to_uni_title_lc
1124 \&  to_uni_upper_lc
1125 \&  utf8_distance
1126 \&  utf8_hop
1127 \&  vcroak
1128 \&  vform
1129 \&  vmess
1130 \&  vwarn
1131 \&  vwarner
1132 .Ve
1133 .IP "perl 5.005_03" 4
1134 .IX Item "perl 5.005_03"
1135 .Vb 3
1136 \&  POPpx
1137 \&  get_vtbl
1138 \&  save_generic_svref
1139 .Ve
1140 .IP "perl 5.005" 4
1141 .IX Item "perl 5.005"
1142 .Vb 26
1143 \&  PL_modglobal
1144 \&  cx_dump
1145 \&  debop
1146 \&  debprofdump
1147 \&  fbm_compile
1148 \&  fbm_instr
1149 \&  get_op_descs
1150 \&  get_op_names
1151 \&  init_stacks
1152 \&  mg_length
1153 \&  mg_size
1154 \&  newHVhv
1155 \&  new_stackinfo
1156 \&  regdump
1157 \&  regexec_flags
1158 \&  regnext
1159 \&  runops_debug
1160 \&  runops_standard
1161 \&  save_iv
1162 \&  screaminstr
1163 \&  sv_iv
1164 \&  sv_nv
1165 \&  sv_peek
1166 \&  sv_pvn
1167 \&  sv_pvn_nomg
1168 \&  sv_true
1169 .Ve
1170 .IP "perl 5.004_05" 4
1171 .IX Item "perl 5.004_05"
1172 .Vb 3
1173 \&  do_binmode
1174 \&  save_aelem
1175 \&  save_helem
1176 .Ve
1177 .IP "perl 5.004" 4
1178 .IX Item "perl 5.004"
1179 .Vb 67
1180 \&  GIMME_V
1181 \&  G_VOID
1182 \&  HEf_SVKEY
1183 \&  HeHASH
1184 \&  HeKEY
1185 \&  HeKLEN
1186 \&  HePV
1187 \&  HeSVKEY
1188 \&  HeSVKEY_force
1189 \&  HeSVKEY_set
1190 \&  HeVAL
1191 \&  SvSetMagicSV
1192 \&  SvSetMagicSV_nosteal
1193 \&  SvSetSV_nosteal
1194 \&  SvTAINTED
1195 \&  SvTAINTED_off
1196 \&  SvTAINTED_on
1197 \&  block_gimme
1198 \&  call_list
1199 \&  cv_const_sv
1200 \&  delimcpy
1201 \&  do_open
1202 \&  form
1203 \&  gv_autoload4
1204 \&  gv_efullname3
1205 \&  gv_fetchmethod_autoload
1206 \&  gv_fullname3
1207 \&  hv_delayfree_ent
1208 \&  hv_delete_ent
1209 \&  hv_exists_ent
1210 \&  hv_fetch_ent
1211 \&  hv_free_ent
1212 \&  hv_iterkeysv
1213 \&  hv_ksplit
1214 \&  hv_store_ent
1215 \&  ibcmp_locale
1216 \&  my_failure_exit
1217 \&  my_memcmp
1218 \&  my_pclose
1219 \&  my_popen
1220 \&  newSVpvf
1221 \&  rsignal
1222 \&  rsignal_state
1223 \&  save_I16
1224 \&  save_gp
1225 \&  share_hek
1226 \&  start_subparse
1227 \&  sv_catpvf
1228 \&  sv_catpvf_mg
1229 \&  sv_cmp_locale
1230 \&  sv_derived_from
1231 \&  sv_gets
1232 \&  sv_magic_portable
1233 \&  sv_setpvf
1234 \&  sv_setpvf_mg
1235 \&  sv_taint
1236 \&  sv_tainted
1237 \&  sv_untaint
1238 \&  sv_vcatpvf
1239 \&  sv_vcatpvf_mg
1240 \&  sv_vcatpvfn
1241 \&  sv_vsetpvf
1242 \&  sv_vsetpvf_mg
1243 \&  sv_vsetpvfn
1244 \&  unsharepvn
1245 \&  vnewSVpvf
1246 \&  warner
1247 .Ve
1248 .SH "BUGS"
1249 .IX Header "BUGS"
1250 If you find any bugs, \f(CW\*(C`Devel::PPPort\*(C'\fR doesn't seem to build on your
1251 system or any of its tests fail, please use the \s-1CPAN\s0 Request Tracker
1252 at <http://rt.cpan.org/> to create a ticket for the module.
1253 .SH "AUTHORS"
1254 .IX Header "AUTHORS"
1255 .IP "\(bu" 2
1256 Version 1.x of Devel::PPPort was written by Kenneth Albanowski.
1257 .IP "\(bu" 2
1258 Version 2.x was ported to the Perl core by Paul Marquess.
1259 .IP "\(bu" 2
1260 Version 3.x was ported back to \s-1CPAN\s0 by Marcus Holland\-Moritz.
1261 .SH "COPYRIGHT"
1262 .IX Header "COPYRIGHT"
1263 Version 3.x, Copyright (C) 2004\-2009, Marcus Holland\-Moritz.
1264 .PP
1265 Version 2.x, Copyright (C) 2001, Paul Marquess.
1266 .PP
1267 Version 1.x, Copyright (C) 1999, Kenneth Albanowski.
1268 .PP
1269 This program is free software; you can redistribute it and/or
1270 modify it under the same terms as Perl itself.
1271 .SH "SEE ALSO"
1272 .IX Header "SEE ALSO"
1273 See h2xs, ppport.h.