1 files changed, 143 insertions, 0 deletions
diff --git a/man/uri_set.3 b/man/uri_set.3
new file mode 100644
index 0000000..0daf51b
--- /dev/null
+++ b/man/uri_set.3
@@ -0,0 +1,143 @@
+.Dd Jan 18, 2021
+.Dt YURI 3
+.Sh NAME
+.Nm uri_set_scheme ,
+.Nm uri_set_authority ,
+.Nm uri_set_authority_type ,
+.Nm uri_set_authority_user ,
+.Nm uri_set_authority_host ,
+.Nm uri_set_authority_port ,
+.Nm uri_append_path ,
+.Nm uri_set_query ,
+.Nm uri_set_fragment
+.Nd URI object manipulation functions
+.Sh SYNOPSIS
+.In yuri.h
+.Ft int
+.Fo uri_set_scheme
+.Fa "struct uri *u"
+.Fa "const char *scheme"
+.Fc
+.Ft int
+.Fo uri_set_authority
+.Fa "struct uri *u"
+.Fa "int type"
+.Fa "const char *user"
+.Fa "const char *host"
+.Fa "int port"
+.Fc
+.Ft int
+.Fo uri_set_authority_type
+.Fa "struct uri *u"
+.Fa "int type"
+.Fc
+.Ft int
+.Fo uri_set_authority_user
+.Fa "struct uri *u"
+.Fa "const char *user"
+.Fc
+.Ft int
+.Fo uri_set_authority_host
+.Fa "struct uri *u"
+.Fa "const char *host"
+.Fc
+.Ft int
+.Fo uri_set_authority_port
+.Fa "struct uri *u"
+.Fa "int port"
+.Fc
+.Ft int
+.Fo uri_append_path
+.Fa "struct uri *u"
+.Fa "const char *elem"
+.Fc
+.Ft int
+.Fo uri_set_query
+.Fa "struct uri *u"
+.Fa "const char *query"
+.Fc
+.Ft int
+.Fo uri_set_fragment
+.Fa "struct uri *u"
+.Fa "const char *fragment"
+.Fc
+.Sh DESCRIPTION
+.Fn uri_set_scheme
+sets the scheme component of URI object pointed to by
+.Em u
+to string pointed to by
+.Em scheme .
+.Pp
+.Fn uri_set_authority
+sets the authority component of URI object pointed to by
+.Em u
+where
+.Em type
+would be the host type,
+.Em user
+would be the user subcomponent,
+.Em host
+would be the host subcomponent, and
+.Em port
+would be the host port.
+.Pp
+Possible values for
+.Em type
+are as follows:
+.Bd -literal -offset indent
+#define YURI_HOST_NAME     1 /* DNS name */
+#define YURI_HOST_IP4      2 /* IPv4 address */
+#define YURI_HOST_IP6      3 /* IPv6 address */
+#define YURI_HOST_IPFUTURE 4 /* Future-proof place holder set
+                                by RFC 3986 for IP versions above v6 */
+.Ed
+.Pp
+.Em user
+and
+.Em port
+can be omitted by setting their values to
+.Nm NULL
+or
+.Em 0
+respectively, however,
+.Em type
+and
+.Em host
+are mandatory.
+.Pp
+.Fn uri_set_authority_type ,
+.Fn uri_set_authority_user ,
+.Fn uri_set_authority_host
+and
+.Fn uri_set_authority_port
+set corresponding authority subcomponenets individually.
+.Pp
+.Fn uri_append_path
+appends path segment pointed to by
+.Em elem
+to the URI object pointed to by
+.Em u .
+.Pp
+.Fn uri_set_query
+sets the query component of URI object pointed to by
+.Em u
+to query string pointed to by
+.Em query .
+.Pp
+.Fn uri_set_fragment
+sets the fragment component for URI object pointed to by
+.Em u
+to fragment string pointed to by
+.Em fragment .
+.Sh RETURN VALUES
+All above functions return
+.Em 0
+on success, or
+.Em -1
+on failure.
+.Sh SEE ALSO
+.Xr uri 3 ,
+.Xr uri_unset 3 ,
+.Xr uri_get 3
+.Sh AUTHORS
+.An Ali Fardan Aq Mt raiz@stellarbound.space