diff options
Diffstat (limited to 'dev-perl/perl-headers/files/README.gentoo')
-rw-r--r-- | dev-perl/perl-headers/files/README.gentoo | 23 |
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 00000000000..5bbe5dc1845 --- /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 ) |