Gdzie jest dokumentacja dla Perla wbudowana w pakiet `Internals ::`?

Question

Podczas korzystania z keys %:: w celu pobrania listy aktualnie załadowanych obszarów nazw root, domyślnie jest ładowany pakiet Internals:: (wraz z UNIVERSAL:: i kilkoma innymi). Jednak nie znalazłem żadnej dokumentacji funkcji w Internals::

keys %{Internals::} zwrotów SvREFCNT hv_clear_placeholders hash_seed SvREADONLY HvREHASH rehash_seed

Wszystkie te można prawdopodobnie spojrzał w C docs API Perla, ale jest jakaś dokumentacja poziom Perl dla nich? Czy paczka jest stabilna? Jest używany przez kilka podstawowych modułów (na przykład Hash::Util), więc wyobrażam sobie, że tak jest, ale brak dokumentacji jest nieco kłopotliwy.

Nie widziałem Internals.pm w dystrybucji Perla (może inna nazwa?), A nie jest to modułna CPAN.

Uwaga: w pełni rozumiem, że funkcje w Internals:: są potencjalnie niebezpieczne i nie mam żadnego konkretnego zastosowania. Czytałem przez źródło Hash::Util i natknąłem się na niego.

Answer 1

Kod IIRC to nie Internals.pm, ale libinternals.c. Wygląda na to, że były kiedyś w wersji universal.c in Perl 5.8, ale zostały przeniesione.

Zgodnie z 03/2009 i Perl 5.10 nie zostały one udokumentowane zgodnie z this perlmonks thread.

Również w tym samym wątku, ysth stany:

Nielegalni rzeczy w universal.c nie powinna być uzależniona od; powinny one być używane tylko przez moduły podstawowe. One nie są celowo dokumentowane, aby można było je zmienić za każdym razem i , jednak konieczne. Dla tych celów kod jest wystarczająco dobrą dokumentacją.