id	summary	reporter	owner	description	type	status	priority	milestone	component	version	severity	resolution	keywords	cc	lang	patch	platform
2125	rename parrot.h to internals.h or private.h or equivalent	pmichaud		"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.

Pm"	RFC	new	minor		core	master	low