.\" The following commands are required for all man pages.
.Dd August 31, 2007
.Os ""
.Dt URLINT 1
.\" ----------------------------------------------------------------
.Sh NAME
.\" 
.Nm urlint
.Nd check HTML files for broken links
.\" ----------------------------------------------------------------
.Sh SYNOPSIS
.\" 
.Nm urlint
.Op Fl v
.Ar filename ...
.\" ----------------------------------------------------------------
.Sh DESCRIPTION
.\" 
.Nm urlint
reads one or more HTML source files and attempts to fetch each
hyperlinked document referenced within them.  For each link that
cannot be fetched,
.Nm urlint
prints the name of the source file, a short description of the
problem, and the problematic link's URI.
output.
.Pp
The following options are available:
.Bl -tag -width indent
.It Fl v
be more verbose: print the repsonse code for every URI that is fetched.
.El
.\" ----------------------------------------------------------------
.Sh EXAMPLES
.\" 
The command
.Bd -literal -offset indent
urlint /home/httpd/html/index.html
.Ed
.Pp
reads
.Pa /home/httpd/html/index.html
and fetches all hyperlinked documents referenced within it, printing
an error message for any documents that cannot be located.
.\" ----------------------------------------------------------------
.Sh SEE ALSO
.\" 
.Xr curl 1 ,
.Xr libcurl 3
.\" ----------------------------------------------------------------
.Sh AUTHORS
.\" 
.Nm urlint
and its manual page were written by
.An "Ian Piumarta" .
.Pp
The software is provided as-is, with absolutely no warranty, in the
hope that you will enjoy and benefit from it.  You may use (entirely
at your own risk) and redistribute it under the terms of a very
liberal license that does not seek to restrict your rights in any way
(unlike a certain popular 'free' license/virus that propagates by
pernicious contagion).
.\" ----------------------------------------------------------------
.Sh BUGS
.\" 
.Bl -bullet
.It
Relative URIs are not handled well.
.It
A HTTP HEAD request is sent to the server for every hyperlinked
document in the source files.  There is no attempt to send only one
such request for each unique URI.  This can be hard on servers when
most links are for internal navigation.
.El
.Pp
Please send bug reports to the author at: firstName (at) lastName
(dot) com.  (See
.Sx AUTHORS
above for suitable values of firstName and lastName.)