[hackers] [sent] Add a manpage || FRIGN

From: <git_AT_suckless.org>
Date: Fri, 12 Aug 2016 13:23:08 +0200 (CEST)

commit b737e3e6af9e6999baace5d453e405f32c60b2d2
Author: FRIGN <dev_AT_frign.de>
AuthorDate: Fri Aug 12 11:36:15 2016 +0200
Commit: Markus Teich <markus.teich_AT_stusta.mhn.de>
CommitDate: Fri Aug 12 13:20:49 2016 +0200

    Add a manpage

diff --git a/Makefile b/Makefile
index 9eaf922..56e6367 100644
--- a/Makefile
+++ b/Makefile
_AT_@ -48,6 +48,10 @@ install: all
         _AT_mkdir -p ${DESTDIR}${PREFIX}/bin
         _AT_cp -f sent ${DESTDIR}${PREFIX}/bin
         _AT_chmod 755 ${DESTDIR}${PREFIX}/bin/sent
+ _AT_echo installing manual page to ${DESTDIR}${MANPREFIX}/man1
+ _AT_mkdir -p ${DESTDIR}${MANPREFIX}/man1
+ _AT_cp sent.1 ${DESTDIR}${MANPREFIX}/man1/sent.1
+ _AT_chmod 644 ${DESTDIR}${MANPREFIX}/man1/sent.1
 
 uninstall:
         _AT_echo removing executable file from ${DESTDIR}${PREFIX}/bin
diff --git a/sent.1 b/sent.1
new file mode 100644
index 0000000..d374bcd
--- /dev/null
+++ b/sent.1
_AT_@ -0,0 +1,66 @@
+.Dd 2016-08-12
+.Dt SENT 1
+.Sh NAME
+.Nm sent
+.Nd simple plaintext presentation tool
+.Sh SYNOPSIS
+.Nm
+.Op Fl v
+.Op Ar file
+.Sh DESCRIPTION
+.Nm
+is a simple plaintext presentation tool for X. It does not need LaTeX,
+LibreOffice or any other fancy file format. Instead, it uses plaintext
+files to describe the slides, including support for images.
+.Pp
+Every paragraph represents a slide in the presentation. Especially for
+presentations using the Takahashi method this is very nice and allows
+you to write down the presentation for a quick lightning talk within a
+few minutes.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl v
+Print version information to stdout and exit.
+.El
+.Sh USAGE
+.Bl -tag -width Ds
+.It Em Mouse commands
+.Bl -tag -width Ds
+.It Sy Button1 | Button5
+Go to next slide, if existant.
+.It Sy Button3 | Button4
+Go to previous slide, if existant.
+.El
+.It Em Keyboard commands
+.Bl -tag -width Ds
+.It Sy Escape | q
+Quit.
+.It Sy Right | Return | Space | l | j | Down | Next | n
+Go to next slide, if existant.
+.It Sy Left | Backspace | h | k | Up | Prior | p
+Go to previous slide, if existant.
+.El
+.El
+.Sh FORMAT
+The presentation file is made up of at least one paragraph, with an
+empty line separating two slides.
+Each input line is interpreted literally, except from control characters
+at the beginning of lines described as follows:
+.Bl -tag -width Ds
+.It Sy _AT_
+Create individual slide containing the image pointed to by the filename
+following the
+.Sy _AT_ .
+.It Sy #
+Ignore this input line.
+.It Sy \e
+Create input line using the characters following the
+.Sy \e
+without interpreting them.
+.El
+.Sh CUSTOMIZATION
+.Nm
+can be customized by creating a custom config.h and (re)compiling the
+source code. This keeps it fast, secure and simple.
+.Sh SEE ALSO
+.Xr 2ff 1
Received on Fri Aug 12 2016 - 13:23:08 CEST