1 files changed, 52 insertions, 0 deletions
diff --git a/doc/man/tld_check_4z.3 b/doc/man/tld_check_4z.3
new file mode 100644
index 0000000..2844102
--- /dev/null
+++ b/doc/man/tld_check_4z.3
@@ -0,0 +1,52 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
+.TH "tld_check_4z" 3 "1.15" "libidn" "libidn"
+.SH NAME
+tld_check_4z \- verify that characters are permitted
+.SH SYNOPSIS
+.B #include <tld.h>
+.sp
+.BI "int tld_check_4z(const uint32_t * " in ", size_t * " errpos ", const Tld_table ** " overrides ");"
+.SH ARGUMENTS
+.IP "const uint32_t * in" 12
+Zero\-terminated array of unicode code points to process.
+.IP "size_t * errpos" 12
+Position of offending character is returned here.
+.IP "const Tld_table ** overrides" 12
+A \fBTld_table\fP array of additional domain restriction
+structures that complement and supersede the built\-in information.
+.SH "DESCRIPTION"
+Test each of the code points in \fIin\fP for whether or not they are
+allowed by the information in \fIoverrides\fP or by the built\-in TLD
+restriction data. When data for the same TLD is available both
+internally and in \fIoverrides\fP, the information in \fIoverrides\fP takes
+precedence. If several entries for a specific TLD are found, the
+first one is used.  If \fIoverrides\fP is \fBNULL\fP, only the built\-in
+information is used.  The position of the first offending character
+is returned in \fIerrpos\fP.
+.SH "RETURN VALUE"
+Returns the \fBTld_rc\fP value \fBTLD_SUCCESS\fP if all code
+points are valid or when \fItld\fP is null, \fBTLD_INVALID\fP if a
+character is not allowed, or additional error codes on general
+failure conditions.
+.SH "REPORTING BUGS"
+Report bugs to <bug-libidn@gnu.org>.
+GNU Libidn home page: http://www.gnu.org/software/libidn/
+General help using GNU software: http://www.gnu.org/gethelp/
+.SH COPYRIGHT
+Copyright \(co 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Simon Josefsson.
+.br
+Copying and distribution of this file, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.
+.SH "SEE ALSO"
+The full documentation for
+.B libidn
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B libidn
+programs are properly installed at your site, the command
+.IP
+.B info libidn
+.PP
+should give you access to the complete manual.