gentoo resync : 14.07.2018

1 files changed, 23 insertions, 0 deletions

diff --git a/dev-perl/perl-headers/files/README.gentoo b/dev-perl/perl-headers/files/README.gentoo
new file mode 100644
index 000000000000..5bbe5dc18452
--- /dev/null
+++ b/dev-perl/perl-headers/files/README.gentoo
@@ -0,0 +1,23 @@
+This package contains .ph files that are mostly generated by the perl h2ph
+command by inspecting existing .h files on your system.
+
+Due to the nature of these files, they are likely to be incomplete, and many
+of them may not even load in Perl, and many things that rely on C intrinsics
+like "sizeof" or macro expansion may be very broken.
+
+It is strongly recommended you build this package with:
+
+  USE="debug sizeof-warning"
+
+As this will give better context when things break, and will at least notify
+you when some constant relies on a missing "sizeof" entry ( and where ).
+
+Missing "sizeof" entries and broken constants need a lot of love, so please
+file bugs at https://github.com/gentoo-perl/perl-headers/issues ( or on
+gentoo bugzilla ) if you find anything that you know how to fix.
+
+However, the logic is kinda broken in a lot of places, and there's not a lot
+that can be done about it as we're reliant on the vernerable quality of h2ph,
+and this package is provided mostly as a kindness to people who need it, and
+were already relying on the equivalent logic that we shipped with perl itself
+prior to 5.24 ( where it was horribly broken and nobody really noticed )