From 3451ddaf73738df133b8fcef2043899921d74c88 Mon Sep 17 00:00:00 2001 From: Pali Date: Mon, 17 Jun 2019 15:54:13 +0200 Subject: [PATCH] Document D_PPP_ prefix for macros (cherry picked from commit 7556987e03558cd2f200df996ee222da58e5889c) Signed-off-by: Nicolas R --- dist/Devel-PPPort/HACKERS | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/dist/Devel-PPPort/HACKERS b/dist/Devel-PPPort/HACKERS index 1db7f34..ff215a4 100644 --- a/dist/Devel-PPPort/HACKERS +++ b/dist/Devel-PPPort/HACKERS @@ -244,6 +244,13 @@ the line C<__UNDEFINED__> to the C<=provides> section to get all macros implemented this way to be imported into this section, so they all get documented as being provided. +If you need to define a helper macro which is not part of C API +and its usage is only for definition of other C macros then use +the C prefix for this macro name (e.g. C). +Some C scripts would report a warning when there is defined a +macro which is not part of Perl public API, except those macros which start +with the C prefix. + Version checking can be tricky if you want to do it correct. You can use -- 1.8.3.1