4 files changed, 205 insertions, 5 deletions

diff --git a/Makefile.am b/Makefile.am
index 70ff5fb..c5e10f1 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -83,6 +83,7 @@ man_MANS				= doc/mans/bindletools.1 \
                                           doc/mans/bindletools-base64.1 \
                                           doc/mans/bindletools-crockfordbase32.1 \
                                           doc/mans/bindletools-pctenc.1 \
+                                          doc/mans/bindletools-urldesc.1 \
                                           doc/mans/bindle_array.3 \
                                           doc/mans/bindle_basename_r.3 \
                                           doc/mans/bindle_bindex.3 \
@@ -142,6 +143,7 @@ EXTRA_DIST				= $(doc_DATA) \
                                           doc/mans/bindletools-base64.1.in \
                                           doc/mans/bindletools-crockfordbase32.1.in \
                                           doc/mans/bindletools-pctenc.1.in \
+                                          doc/mans/bindletools-urldesc.1.in \
                                           doc/mans/bindle_array.3.in \
                                           doc/mans/bindle_basename_r.3.in \
                                           doc/mans/bindle_bindex.3.in \
@@ -303,6 +305,9 @@ doc/mans/bindletools-crockfordbase32.1: Makefile $(srcdir)/doc/mans/bindletools-
 doc/mans/bindletools-pctenc.1: Makefile $(srcdir)/doc/mans/bindletools-pctenc.1.in
         @$(do_subst_dt)
 
+doc/mans/bindletools-urldesc.1: Makefile $(srcdir)/doc/mans/bindletools-urldesc.1.in
+        @$(do_subst_dt)
+
 doc/mans/bindle_array.3: Makefile $(srcdir)/doc/mans/bindle_array.3.in
         @$(do_subst_dt)
 
diff --git a/TODO.md b/TODO.md
index 3eaca3c..779f982 100644
--- a/TODO.md
+++ b/TODO.md
@@ -10,7 +10,6 @@ All rights reserved.
 #### documentation
    * bindletools Man Pages
      - write bindletools-expand.1
-     - write bindletools-urldesc.1
    * libbindle Man Pages
      - write bindle_debug.3
      - write bindle_get_option.3
diff --git a/doc/mans/bindletools-urldesc.1.in b/doc/mans/bindletools-urldesc.1.in
new file mode 100644
index 0000000..6834ac7
--- /dev/null
+++ b/doc/mans/bindletools-urldesc.1.in
@@ -0,0 +1,196 @@
+.\"
+.\" Bindle Binaries Tools
+.\" Copyright (C) 2022 David M. Syzdek <david@syzdek.net>.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions are
+.\" met:
+.\"
+.\"    * Redistributions of source code must retain the above copyright
+.\"      notice, this list of conditions and the following disclaimer.
+.\"    * Redistributions in binary form must reproduce the above copyright
+.\"      notice, this list of conditions and the following disclaimer in the
+.\"      documentation and/or other materials provided with the distribution.
+.\"    * Neither the name of David M. Syzdek nor the
+.\"      names of its contributors may be used to endorse or promote products
+.\"      derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+.\" IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+.\" THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DAVID M. SYZDEK BE LIABLE FOR
+.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.TH "BINDLETOOLS" "1" "@RELEASE_MONTH@" "@PACKAGE_NAME@" "User Commands"
+.SH NAME
+bindletools-urldesc - parses URL
+
+.SH SYNOPSIS
+.nf
+\fBbindletools urldesc\fR [OPTIONS] \fIurl\fR
+.sp
+\fBbindletools-urldesc\fR [OPTIONS] \fIurl\fR
+.sp
+\fBurldesc\fR [OPTIONS] \fIurl\fR
+.fi
+
+.SH DESCRIPTION
+\fBbindletools-urldesc\fR parses general URL (Uniform Resource Locators) or
+URI (Uniform  Resource  Identifier) strings and prints the URL components. The
+syntax of a URI is defined as:
+.sp
+.RS 4
+.nf
+URI = \fIscheme\fR ":" ["//" authority] \fIpath\fR ["?" \fIquery\fR] ["#" \fIfragment\fR]
+authority = [\fIuserinfo\fR "@"] \fIhost\fR [":" \fIport\fR]
+.fi
+.RE
+.PP
+where:
+.RS 4
+.PD 0
+.TP 9
+\fIscheme\fR
+is the specification to use for the URI. The \fIscheme\fR is stored as a
+string to \fIbud_scheme\fR.
+.TP 9
+\fIuserinfo\fR
+is the optional username and password. \fIuserinfo\fR is stored as a string
+to \fIbud_userinfo\fR.
+.TP 9
+\fIhost\fR
+is the host providing the resource. \fIhost\fR is stored as a string to
+\fIbud_host\fR.
+.TP 9
+\fIport\fR
+is the numeric port number or service name on the \fIhost\fR providing the
+service. \fIport\fR is stored as a string to \fIbud_service\fR and stored as
+an integer to \fIbud_port\fR if \fIport\fR is a numeric value.
+.TP 9
+\fIpath\fR
+is the path to the resource. \fIpath\fR is stored as a string to \fIbud_path\fR.
+.TP 9
+\fIquery\fR
+is the non-hierarchical data identifying the resource. \fIquery\fR is stored
+as a string to \fIbud_query\fR.
+.TP 9
+\fIfragment\fR
+is a section of the resource or a secondary resource. \fIfragment\fR is stored
+as a string to \fIbud_fragment\fR.
+.RE
+.PD
+.PP
+Examples:
+.RS 4
+.nf
+https://example.com:8443/demo/
+https://example/demo/#bindletools
+https://example/demo/?q=example
+ftp://jdoe@example.com/pub/demo.txt
+file:/pub/demo.txt
+http://jdoe:cred@example.com:8080/demo/?q=example#bindletools
+.fi
+.RE
+
+.SH OPTIONS
+
+.TP 25
+\fB-4\fR
+resolve IPv4 address of host
+
+.TP 25
+\fB-6\fR
+resolve IPv6 address of host
+
+.TP 25
+\fB-D\fR \fIlevel\fR, \fB--debug\fR=\fIlevel\fR
+set debug level
+
+.TP 25
+\fB-f\fR, \fB--fragment\fR
+print URL fragment
+
+.TP 25
+\fB-H\fR, \fB--host\fR
+print URL host
+
+.TP 25
+\fB-h\fR, \fB--help\fR
+print this usage information and exit
+
+.TP 25
+\fB-n\fR, \fB--dryrun\fR
+do not resolve hostname
+
+.TP 25
+\fB-P\fR, \fB--path\fR
+print URL path
+
+.TP 25
+\fB-p\fR, \fB--port\fR
+print URL port number if \fIservice\fR is a numeric value or if resolving the
+hostname of the URL.
+
+.TP 25
+\fB-Q\fR, \fB--query\fR
+print URL query
+
+.TP 25
+\fB-q\fR, \fB--quiet\fR, \fB--silent\fR
+do not print messages
+
+.TP 25
+\fB-r\fR, \fB--resolve\fR
+resolve hostname and service name
+
+.TP 25
+\fB-S\fR, \fB--service\fR
+print URL service
+
+.TP 25
+\fB-s\fR, \fB--scheme\fR
+print URL scheme
+
+.TP 25
+\fB-u\fR, \fB--userinfo\fR
+print URL userinfo
+
+.TP 25
+\fB-V\fR, \fB--version\fR
+print version number and exit
+
+.TP 25
+\fB-v\fR, \fB--verbose\fR
+print verbose messages
+
+.TP 25
+\fB--all\fR
+print all values, even if empty
+
+.TP 25
+\fB--shell\fR
+print components as shell variables
+
+.TP 25
+\fB--short\fR
+print only component values
+
+.SH SEE ALSO
+.BR bindletools (1),
+.BR bindle_urldesc (3)
+
+.SH AUTHOR
+David M. Syzdek <david@syzdek.net>
+
+.SH ACKNOWLEDGEMENTS
+\fB@PACKAGE_NAME@\fR is developed and maintained by David M. Syzdek
+<david@syzdek.net>.
+
+.\" end of man page
diff --git a/doc/mans/bindletools.1.in b/doc/mans/bindletools.1.in
index ea7e71d..9e7449e 100644
--- a/doc/mans/bindletools.1.in
+++ b/doc/mans/bindletools.1.in
@@ -93,13 +93,13 @@ expand
 expand tokens within string
 
 .TP 20
-expand
-expand tokens within string
-
-.TP 20
 pctenc
 encode/decode percent-encoding/URL encoding string
 
+.TP 20
+urldesc
+parse URL string
+
 .SH SEE ALSO
 .BR bindletools-base16 (1),
 .BR bindletools-base32 (1),