aboutsummaryrefslogtreecommitdiffstats
path: root/www/p5-Data-Validate-URI/pkg-descr
diff options
context:
space:
mode:
Diffstat (limited to 'www/p5-Data-Validate-URI/pkg-descr')
-rw-r--r--www/p5-Data-Validate-URI/pkg-descr18
1 files changed, 18 insertions, 0 deletions
diff --git a/www/p5-Data-Validate-URI/pkg-descr b/www/p5-Data-Validate-URI/pkg-descr
new file mode 100644
index 000000000000..0aa1d7d28f8f
--- /dev/null
+++ b/www/p5-Data-Validate-URI/pkg-descr
@@ -0,0 +1,18 @@
+This module collects common URI validation routines to make input validation,
+and untainting easier and more readable.
+
+All functions return an untainted value if the test passes, and undef if it
+fails. This means that you should always check for a defined status
+explicitly. Don't assume the return will be true.
+
+The value to test is always the first (and often only) argument.
+
+There are a number of other URI validation modules out there as well.
+This one focuses on being fast, lightweight, and relatively 'real-world'.
+i.e. it's good if you want to check user input, and don't need to parse
+out the URI/URL into chunks.
+
+Right now the module focuses on HTTP URIs, since they're arguably the most
+common.
+
+WWW: http://search.cpan.org/dist/Data-Validate-URI