petdance/scratch — Issue #1136: rename parrot.h to internals.h or private.h or equivalent
Author: petdance
Created: 2011-11-14 06:14:50+00:00
State: open
Labels: core, Pri-minor, rfc, Sev-low

Several lines at the beginning of parrot.h read:
```
/* Only parrot core files should include this file.
Extensions should include .
Programs embedding parrot should include .
*/
```

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

Originally http://trac.parrot.org/parrot/ticket/2125 by @pmichaud