1 files changed, 78 insertions, 0 deletions
diff --git a/jotpass.1 b/jotpass.1
new file mode 100644
index 0000000..2aa9bf6
--- /dev/null
+++ b/jotpass.1
@@ -0,0 +1,78 @@
+.\" Copyright (c) 2021 Stefan Kreutz <mail@skreutz.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.Dd $Mdocdate: October 12 2021 $
+.Dt JOTPASS 1
+.Os
+.Sh NAME
+.Nm jotpass
+.Nd Print readable random passwords
+.Sh SYNOPSIS
+.Nm jotpass
+.Op Fl v
+.Op Fl a Ar alphabet
+.Op Fl g Ar groups
+.Op Fl w Ar width
+.Op Fl s Ar separator
+.Sh DESCRIPTION
+The
+.Nm
+utility facilitates generating random passwords suitable for handwriting.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl v
+Enable verbose mode.
+Causes
+.Nm
+to print the entropy of the generated password to standard error.
+.It Fl a Ar alphabet
+Draw characters from the given
+.Ar alphabet .
+Defaults to alphanumeric ASCII characters, excluding 01klnuvIO
+to improve legibility.
+.It Fl g Ar groups
+Set the number of
+.Ar groups .
+Defaults to 12.
+.It Fl w Ar width
+Set the
+.Ar width
+of the groups.
+Defaults to 4 characters.
+.It Fl s Ar separator
+Set the group
+.Ar separator
+character.
+Defaults to dash (-).
+.El
+.Sh EXIT STATUS
+.Ex -std jotpass
+.Sh EXAMPLES
+Print a random password:
+.Bd -literal -offset indent
+$ jotpass
+P6ji-4pRZ-Ze7m-q7Bp-Vpye-HCjr-hygF-6TwQ-oRJT-yx6p-SyMB-AwUm
+.Ed
+.Pp
+Specify a custom format:
+.Bd -literal -offset indent
+$ jotpass -a 0123456789abcdef -g 8 -w 2 -s ' ' -v
+49 1b 6e b0 e2 fc 16 b1
+The generated password has an entropy of 64 bits.
+.Ed
+.Sh SEE ALSO
+.Xr jot 1 ,
+.Xr arc4random 3
+.Sh AUTHORS
+.An Stefan Kreutz Aq Mt mail@skreutz.com