1[manpage_begin uri_urn n 1.1.2]
2[moddesc   {Tcl Uniform Resource Identifier Management}]
3[titledesc {URI utilities, URN scheme}]
4[category  Networking]
5[require Tcl 8.2]
6[require uri::urn [opt 1.1.2]]
7[description]
8
9This package provides two commands to quote and unquote the disallowed
10characters for url using the [term urn] scheme, registers the scheme
11with the package [package uri], and provides internal helpers which
12will be automatically used by the commands [cmd uri::split] and
13[cmd uri::join] of package [package uri] to handle urls using the
14[term urn] scheme.
15
16[section COMMANDS]
17
18[list_begin definitions]
19
20[call [cmd uri::urn::quote] [arg url]]
21
22This command quotes the characters disallowed by the [term urn] scheme
23(per RFC 2141 sec2.2) in the [arg url] and returns the modified url as
24its result.
25
26[call [cmd uri::urn::unquote] [arg url]]
27
28This commands performs the reverse of [cmd ::uri::urn::quote]. It
29takes an [term urn] url, removes the quoting from all disallowed
30characters, and returns the modified urls as its result.
31
32[list_end]
33
34[section {BUGS, IDEAS, FEEDBACK}]
35
36This document, and the package it describes, will undoubtedly contain
37bugs and other problems.
38
39Please report such in the category [emph uri] of the
40[uri {http://sourceforge.net/tracker/?group_id=12883} {Tcllib SF Trackers}].
41
42Please also report any ideas for enhancements you may have for either
43package and/or documentation.
44
45[keywords uri url urn]
46[keywords {rfc 2141}]
47[manpage_end]
48