.Dd July 10, 2025
.Dt autogram 1
.Os
.Sh NAME
.Nm autogram
.Nd generate self-referent sentences
.Sh SYNOPSIS
.Nm
.Fl h
.Nm
.Fl \-version
.Nm
.Op Fl a Ar relaxed | strict | pangram
.Op Fl i Ar max-iter
.Op Fl l Ar language
.Op Fl s Ar start-of-sentemce
.Op Fl v
.Sh DESCRIPTION
The
.Nm
utility generates self-referential sentences that report how many times letters
of the alphabet occur in them.
The numbers are written textually, which makes the sentences self-referential.
.Pp
Three kinds of sentences can be generated: relaxed, strict, or pangram.
.Bl -tag -width Ds
.It relaxed
Only letters that actually occur in the sentence are mentioned.
Counts of one are acceptable.
.It strict
Only letters that actually occur in the sentence are mentioned.
Counts of one are not allowed.
.It pangram
Counts for every letter of the alphabet are mentioned, which makes this a
pangram.
A pangram is any sentence containing every letter of the alphabet, like the
famous
.Dq The quick brown fox jumped over the lazy dog .
.El
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl a, \-autogram Ar relaxed | strict | pangram
Specify the desired type of autogram.
Default is
.Sq relaxed .
.It Fl h, \-help
Print help text and exit.
.It Fl i, \-max-iter Ar count
Specify the maximum number of iterations, before a new seed is chosen.
Default is 10.
.It Fl l, \-lang Ar en | nl
Language for the sentence.
Choose between English
.Ar en
or Dutch
.Ar nl .
.It Fl v, \-verbose
When specified,
.Nm
will show some feedback about the number of iterations it performs.
.It Fl \-version
Print version info and exit.
.El
.\" .Sh ENVIRONMENT
.\" For sections 1, 6, 7, and 8 only.
.Sh FILES
.Bl -tag -width Ds
.It Pa $PREFIX/share/autogram/numerals.db
The sqlite3 database file containing the numerals for the different languages.
.El
.Sh EXIT STATUS
.\" For sections 1, 6, and 8 only.
.Nm
exits 0 on success, and 1 if an error occurs.
.\" .Sh EXAMPLES
.\" .Sh DIAGNOSTICS
.\" For sections 1, 4, 6, 7, 8, and 9 printf/stderr messages only.
.\" .Sh SEE ALSO
.\" .Xr foobar 1
.\" .Sh STANDARDS
.\" .Sh HISTORY
.Sh AUTHORS
Bob Polis
.\" .Sh CAVEATS
.\" .Sh BUGS
.\" .Sh SECURITY CONSIDERATIONS
.\" Not used in OpenBSD.