docs

1 files changed, 53 insertions, 0 deletions

diff --git a/doc/mu123.1 b/doc/mu123.1
new file mode 100644
index 0000000..939467a
--- /dev/null
+++ b/doc/mu123.1
@@ -0,0 +1,53 @@
+.Dd September 2, 2024
+.Dt mu123 1
+.Os
+.Sh NAME
+.Nm mu123
+.Nd audio player that never stops meowing
+.Sh SYNOPSIS
+.Nm mu123
+.Ar audio file
+.Sh DESCRIPTION
+.Nm
+will play the audio file you pass to it
+
+currently supported formats:
+.Bl -bullet
+.It
+s3xmodit
+.It
+midi
+.El
+.Sh ENVIRONMENT
+SOUNDFONT
+
+soundfont to use for midi
+.Sh FILES
+/usr/share/sounds/sf2/default-GM.sf2
+
+default soundfont
+.Sh EXAMPLES
+SOUNDFONT=gm.sf2
+.Nm
+e1m1.mid
+
+will play
+.Em e1m1.mid
+on loop with the soundfont
+.Em gm.sf2
+.Sh SEE ALSO
+.Xr mu-sdl 1
+.Xr openmpt123 1
+.Xr out123 1
+.\" .Sh STANDARDS
+.\" .Sh HISTORY
+.Sh AUTHORS
+.An sylvie
+.\" .Sh CAVEATS
+.Sh BUGS
+loading midi files leaks ~15KB of memory each time
+
+i have no idea how to fix that
+
+.\" .Sh SECURITY CONSIDERATIONS
+.\" Not used in OpenBSD.