url: Allow various `safe' characters unquoted in URL strings.

[mLib] / man / url.3

diff --git a/man/url.3 b/man/url.3
index 5a964033a818d3d0adfe03072a3aee3263d76dbb..919ce933fe86e2fea32040877a428e9f17b632d5 100644 (file)
--- a/man/url.3
+++ b/man/url.3
@@ -57,6 +57,27 @@ string (see
 .BR dstr (3)
 for details).
 .PP
+You can set flags in the encoding context's
+.B f
+member:
+.TP
+.B URLF_STRICT
+Be strict about escaping non-alphanumeric characters.  Without this,
+potentially unsafe characters such as 
+.RB ` / '
+and
+.RB ` ~ '
+will be left unescaped, which makes encoded filenames (for example) more
+readable.
+.TP
+.B URLF_LAX
+Be very lax about non-alphanumeric characters.  Everything except
+obviously-unsafe characters like
+.RB ` & '
+and 
+.RB ` = '
+are left unescaped.
+.PP
 Decoding a sequence of name/value pairs is performed using the
 .B url_dec
 function.  It requires as input a