summaryrefslogtreecommitdiff
path: root/ipdir.h
diff options
context:
space:
mode:
Diffstat (limited to 'ipdir.h')
-rw-r--r--ipdir.h34
1 files changed, 34 insertions, 0 deletions
diff --git a/ipdir.h b/ipdir.h
index d5c2c2f9ad..f0dadc411e 100644
--- a/ipdir.h
+++ b/ipdir.h
@@ -5,6 +5,40 @@
*/
+
+/*
+ PerlXXX_YYY explained - DickH and DougL @ ActiveState.com
+
+XXX := functional group
+YYY := stdlib/OS function name
+
+Continuing with the theme of PerlIO, all OS functionality was
+encapsulated into one of several interfaces.
+
+PerlIO - stdio
+PerlLIO - low level I/O
+PerlMem - malloc, realloc, free
+PerlDir - directory related
+PerlEnv - process environment handling
+PerlProc - process control
+PerlSock - socket functions
+
+
+The features of this are:
+1. All OS dependant code is in the Perl Host and not the Perl Core.
+ (At least this is the holy grail goal of this work)
+2. The Perl Host (see perl.h for description) can provide a new and
+ improved interface to OS functionality if required.
+3. Developers can easily hook into the OS calls for instrumentation
+ or diagnostic purposes.
+
+What was changed to do this:
+1. All calls to OS functions were replaced with PerlXXX_YYY
+
+*/
+
+
+
#ifndef __Inc__IPerlDir___
#define __Inc__IPerlDir___