.Dd September 10, 2019
.Dt TITLE 1
.Os
.
.Sh NAME
.Nm title
.Nd page titles
.
.Sh SYNOPSIS
.Nm
.Op Fl v
.Op Fl x Ar pattern
.Op Ar url
.
.Sh DESCRIPTION
.Nm
fetches HTML page titles
over HTTP and HTTPS.
.Nm
scans standard input for URLs
and writes their titles to standard output.
If a
.Ar url
argument is given,
.Nm
exits after fetching its title.
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl x Ar pattern
Exclude URLs matching
.Ar pattern ,
which is a modern regular expression.
See
.Xr re_format 7 .
.It Fl v
Enable
.Xr libcurl 3
verbose output.
.El
.
.Sh EXAMPLES
.Bd -literal -offset indent
mkfifo snarf titles
relay irc.example.org 6697 snarf '#example' <>titles >snarf
title <snarf >titles
.Ed
.
.Sh SEE ALSO
.Xr relay 1