¿Dónde está la documentación para el paquete integrado `Internals ::` de Perl?

Question

Al usar keys %:: para obtener una lista de los espacios de nombres raíz cargados actualmente, el paquete Internals:: se carga de manera predeterminada (junto con UNIVERSAL:: y algunos otros). Sin embargo, no he encontrado ninguna documentación para las funciones en Internals::

keys %{Internals::} vuelve SvREFCNT hv_clear_placeholders hash_seed SvREADONLY HvREHASH rehash_seed

Todo esto probablemente se pueden consultar en la documentación de la API C de Perl, pero ¿hay alguna documentación de nivel de Perl para ellos? ¿El paquete es estable? Es utilizado por varios módulos principales (Hash::Util para uno), así que me lo imagino, pero la falta de documentación es un poco problemática.

No vi Internals.pm en la distribución de Perl (¿diferente nombre quizás?), Y no es el módulo Internals en CPAN.

Nota: Entiendo completamente que las funciones en Internals:: son potencialmente peligrosas, y no tengo ningún uso particular en mente. Estaba leyendo a través de la fuente Hash::Util y lo encontré.

Answer 1

IIRC el código no es Internals.pm sino libinternals.c. Parece que solían estar en universal.c in Perl 5.8 pero se migraron.

Según 03/2009 y Perl 5.10 no se documentaron según this perlmonks thread.

También, en el mismo hilo, ysth estados:

cosas indocumentados en universal.c no deberán tomarse para; deberían solo ser utilizados por módulos centrales. Ellos no están documentados a propósito, para permitir que se cambien cada vez que sea necesario y . Para esos fines, el código es suficiente documentación.