X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/mLib/blobdiff_plain/0ddebb8f377a5daa1f546f18a956db99c54685ca..7e4708e456b17131f28ae7f1ff7b5c7f86e2f803:/man/url.3 diff --git a/man/url.3 b/man/url.3 index 5a96403..919ce93 100644 --- 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