.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PHOSH-SESSION"  "" ""
.SH NAME
phosh-session \- Session startup script for phosh
.SH SYNOPSIS
.nf
\fBphosh\-session\fP [OPTIONS...]
.fi
.sp
.SH DESCRIPTION
.sp
\fBphosh\-session\fP is the script to startup phosh including required
components like the Wayland compositor \fBphoc\fP and an on screen
keyboard like \fBsqueekboard\fP\&.  The script is rarely invoked by a user
but rather activated by a display manager or systemd unit. However
it\(aqs perfectly valid to e.g. log into a tty and run \fBphosh\-session\fP
to bring up phosh and needed components.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-h\fP, \fB\-\-help\fP
Print help and exit
.TP
.B \fB\-\-version\fP
Print version and exit
.UNINDENT
.SH CONFIGURATION FILES
.sp
The session script looks at the following configuration files:
.INDENT 0.0
.IP \(bu 2
\fB/usr/share/phosh/phoc.ini\fP: Configuration passed to the compositor
.IP \(bu 2
\fB/etc/phosh/phoc.ini\fP: Used instead of the above if present
.UNINDENT
.SH ENVIRONMENT VARIABLES
.sp
\fBphosh\-session\fP honors the following environment variables:
.INDENT 0.0
.IP \(bu 2
\fBWLR_BACKENDS\fP: The backends the wlroots library should use when phoc launches. See
\fI\%https://gitlab.freedesktop.org/wlroots/wlroots/\-/blob/master/docs/env_vars.md\fP
.UNINDENT
.sp
For debugging purposes you can put environment variables into
\fB~/.phoshdebug\fP which is read at session startup.
.SH SEE ALSO
.sp
\fBphosh(1)\fP \fBphoc(1)\fP \fBphoc.ini(5)\fP
.\" Generated by docutils manpage writer.
.