|
314 | 314 | : circumstances dictate otherwise, they can be anywhere, provided the
|
315 | 315 | : whole function is wrapped with
|
316 | 316 | :
|
317 |
| -: #ifndef NO_MATHOMS |
318 |
| -: ... |
319 |
| -: #endif |
| 317 | +: #ifndef NO_MATHOMS |
| 318 | +: ... |
| 319 | +: #endif |
320 | 320 | :
|
321 | 321 | : Note that this flag no longer automatically adds a 'Perl_' prefix to
|
322 | 322 | : the name. Additionally specify 'p' to do that.
|
|
370 | 370 | : then it is assumed to take a strftime-style format string as the 1st
|
371 | 371 | : arg; otherwise it's assumed to take a printf style format string, not
|
372 | 372 | : necessarily the 1st arg. All the arguments following the second form
|
373 |
| -: (including possibly '...') are assumed to be for the format. |
| 373 | +: (including possibly '...') are assumed to be for the format. |
374 | 374 | :
|
375 | 375 | : embed.h: any entry in here for the second form is suppressed because
|
376 |
| -: of varargs |
| 376 | +: of varargs |
377 | 377 | : proto.h: add __attribute__format__ (or ...null_ok__)
|
378 | 378 | :
|
379 | 379 | : 'F' Function has a '...' parameter, but don't assume it is a format. This
|
|
396 | 396 | : one NN argument.
|
397 | 397 | :
|
398 | 398 | : proto.h: PERL_ARGS_ASSERT macro is not defined unless the function
|
399 |
| -: has NN arguments |
| 399 | +: has NN arguments |
400 | 400 | :
|
401 | 401 | : 'h' Hide any documentation that would normally go into perlapi or
|
402 | 402 | : perlintern. This is typically used when the documentation is actually
|
|
427 | 427 | : particular C file(s) or in the perl core.) Therefore, all non-guarded
|
428 | 428 | : functions should also have the 'p' flag specified to avoid polluting
|
429 | 429 | : the XS code name space. Otherwise, this flag also turns on the 'S'
|
430 |
| -: flag. |
| 430 | +: flag. |
431 | 431 | :
|
432 | 432 | : proto.h: function is declared as PERL_STATIC_INLINE
|
433 | 433 | :
|
|
444 | 444 | : parameter unless the 'T' flag is specified.
|
445 | 445 | :
|
446 | 446 | : suppress proto.h entry (actually, not suppressed, but commented out)
|
447 |
| -: suppress entry in the list of exported symbols available on all platforms |
| 447 | +: suppress entry in the list of exported symbols available on all |
| 448 | +: platforms |
448 | 449 | : suppress embed.h entry, as the implementation should furnish the macro
|
449 | 450 | :
|
450 | 451 | : 'M' The implementation is furnishing its own macro instead of relying on
|
|
489 | 490 | :
|
490 | 491 | : 'o' Has no Perl_foo or S_foo compatibility macro:
|
491 | 492 | :
|
492 |
| -: This is used for whatever reason to force the function to be called |
493 |
| -: with the long name. Perhaps there is a varargs issue. Use the 'M' |
494 |
| -: flag instead for wrapper macros, and legacy-only functions should |
495 |
| -: also use 'b'. |
| 493 | +: This is used for whatever reason to force the function to be called |
| 494 | +: with the long name. Perhaps there is a varargs issue. Use the 'M' |
| 495 | +: flag instead for wrapper macros, and legacy-only functions should |
| 496 | +: also use 'b'. |
496 | 497 | :
|
497 | 498 | : embed.h: suppress "#define foo Perl_foo"
|
498 | 499 | :
|
|
543 | 544 | :
|
544 | 545 | : 's' Static function, but function in source code has a Perl_ prefix:
|
545 | 546 | :
|
546 |
| -: This is used for functions that have always had a Perl_ prefix, but |
547 |
| -: have been moved to a header file and declared static. |
| 547 | +: This is used for functions that have always had a Perl_ prefix, but |
| 548 | +: have been moved to a header file and declared static. |
548 | 549 | :
|
549 | 550 | : proto.h: function is declared as Perl_foo rather than foo
|
550 | 551 | : STATIC is added to declaration;
|
|
579 | 580 | : compatibility issues.
|
580 | 581 | :
|
581 | 582 | : 'W' Add a comma_pDEPTH argument to function prototypes, and a comma_aDEPTH
|
582 |
| -: argument to the function calls. This means that under DEBUGGING a |
583 |
| -: depth argument is added to the functions, which is used for example by |
584 |
| -: the regex engine for debugging and trace output. A non DEBUGGING build |
585 |
| -: will not pass the unused argument. Currently restricted to functions |
586 |
| -: with at least one argument. |
| 583 | +: argument to the function calls. This means that under DEBUGGING a |
| 584 | +: depth argument is added to the functions, which is used for example by |
| 585 | +: the regex engine for debugging and trace output. A non DEBUGGING build |
| 586 | +: will not pass the unused argument. Currently restricted to functions |
| 587 | +: with at least one argument. |
587 | 588 | :
|
588 | 589 | : 'X' Explicitly exported:
|
589 | 590 | :
|
|
0 commit comments