Ticket #2125 (new RFC)
rename parrot.h to internals.h or private.h or equivalent
|Reported by:||pmichaud||Owned by:|
Several lines at the beginning of parrot.h read:
/* Only parrot core files should include this file. Extensions should include <parrot/extend.h>. Programs embedding parrot should include <parrot/embed.h>. */
A far more effective approach would be to rename "parrot.h" to "internals.h" or "private.h" or something that makes it much more obvious that the contents are meant for internal use only. People looking to Parrot source code for examples of how to write PMCs, dynpmcs or dynops are unlikely to read the contents of parrot.h and see the warning.