summaryrefslogtreecommitdiff
path: root/data/surf-display.1
diff options
context:
space:
mode:
Diffstat (limited to 'data/surf-display.1')
-rw-r--r--data/surf-display.138
1 files changed, 38 insertions, 0 deletions
diff --git a/data/surf-display.1 b/data/surf-display.1
new file mode 100644
index 0000000..17d3fbe
--- /dev/null
+++ b/data/surf-display.1
@@ -0,0 +1,38 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH surf-display 1 "Mar 2017" "Version 0.0.2" "Surf Kiosk Display"
+.SH NAME
+surf-display \- Fullscreen WWW Display Session Manager
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+\fBsurf-display\fR
+
+.SH DESCRIPTION
+\fBsurf-display\fR is a wrapper around Surf. It can turn a system into a browser based display terminal in KIOSK mode.
+.PP
+\fBsurf-display\fR registers itself as an x-session-manager alternative
+and provides a very minimal X11 session, launching the
+matchbox-window-manager, pulseaudio (if requested) and unclutter (if
+requested) before starting the fullscreen browser session.
+.PP
+\fBsurf-display\fR locks down mouse pointer right-click behaviour and disables various keyboard shortcuts to hide Surf
+functionalities from the user. Out goal is to not let users break out of the given entry WWW site's browsing design.
+.PP
+With \fBsurf-display\fR you can configure what sites to allow the user access to and what sites to block user access from.
+.PP
+.SH OPTIONS
+\fBsurf-display\fR can easily be configured system-wide via /etc/default/surf-display. Overrides can be configure on a per-user basis
+via $HOME/.surf-display/config.
+.PP
+.SH SEE ALSO
+/etc/default/surf-display
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> and Benjamin Schlüter <bschlueter@posteo.de> for the IT-Zukunft-Schule
+project (https://wiki.it-zukunft-schule.de/).