.Dd 2020-10-22
.Dt gemtext 3
.Os
.Sh NAME
.Nm gemtext_list_append
.Nd append to gemtext lists
.Sh SYNOPSIS
.In gemtext.h
.Ft struct gemtext **
.Fo gemtext_list_append
.Fa struct gemtext **list
.Fa struct gemtext *item
.Fc
.Sh DESCRIPTION
.Fn gemtext_list_append
takes a NULL terminated list of
.Em struct gemtext*
and returns a pointer to a newly allocated, NULL terminated list of
.Em struct gemtext*
with
.Em item
appended to the end of the list.
.Sh RETURN VALUES
.Fn gemtext_list_append
returns a valid pointer to
.Em struct gemtext*
upon success, or NULL on error.
.Pp
Pointer returned by
.Fn gemtext_list_append
should be freed after use using
.Xr gemtext_list_free 3 .
.Sh SEE ALSO
.Xr gemtext_decode 3 ,
.Xr gemtext_encode 3 ,
.Xr gemtext_text_new 3 ,
.Xr gemtext_text_string 3 ,
.Xr gemtext_text_strlen 3 ,
.Xr gemtext_type 3 ,
.Xr gemtext_free 3
.Sh AUTHORS
.An Ali Fardan Aq Mt raiz@stellarbound.space