summaryrefslogtreecommitdiff
path: root/devel/p5-IO-Null/DESCR
diff options
context:
space:
mode:
Diffstat (limited to 'devel/p5-IO-Null/DESCR')
-rw-r--r--devel/p5-IO-Null/DESCR10
1 files changed, 10 insertions, 0 deletions
diff --git a/devel/p5-IO-Null/DESCR b/devel/p5-IO-Null/DESCR
new file mode 100644
index 00000000000..5091b8b1b38
--- /dev/null
+++ b/devel/p5-IO-Null/DESCR
@@ -0,0 +1,10 @@
+This is a class for null file handles. Calling a constructor of this
+class always succeeds, returning a new null file handle. Writing to
+any object of this class is always a no-operation, and returns true.
+Reading from any object of this class is always no-operation, and
+returns empty-string or empty-list, as appropriate.
+
+You could say:
+ open(NULL, '>/dev/null') || die "WHAAT?! $!";
+and get a null FH that way. But not everyone is using an OS
+that has a /dev/null