'\" t
.\"     Title: gnome-shell
.\"    Author: Marcelo Jorge Vieira <metal@alucinados.com>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 09/13/2020
.\"    Manual: gnome-shell
.\"    Source: gnome-shell
.\"  Language: English
.\"
.TH "GNOME\-SHELL" "1" "" "gnome-shell" "gnome-shell"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gnome-shell \- Graphical shell for the GNOME desktop
.SH "SYNOPSIS"
.HP \w'\fBgnome\-shell\ \fR\fB[OPTION...]\fR\ 'u
\fBgnome\-shell \fR\fB[OPTION...]\fR
.SH "DESCRIPTION"
.PP
GNOME shell provides core user interface functions for the GNOME 3 desktop, like switching to windows and launching applications\&. GNOME shell takes advantage of the capabilities of modern graphics hardware and introduces innovative user interface concepts to provide a visually attractive and easy to use experience\&.
.PP
gnome\-shell is a required component of the GNOME desktop, i\&.e\&. it is listed in the RequiredComponents field of
/usr/share/gnome\-session/sessions/gnome\&.session\&. It is started in the window manager phase of the session\&.
.SH "OPTIONS"
.PP
\fB\-r\fR, \fB\-\-replace\fR
.RS 4
Replace the running window manager
.RE
.PP
\fB\-\-sm\-disable\fR
.RS 4
Disable connection to the session manager
.RE
.PP
\fB\-\-sm\-client\-id=\fR\fB\fIID\fR\fR
.RS 4
Specify session management
\fIID\fR
.RE
.PP
\fB\-\-sm\-save\-file=\fR\fB\fIFILE\fR\fR
.RS 4
Initialize session from
\fIFILE\fR
.RE
.PP
\fB\-\-screen=\fR\fB\fISCREEN\fR\fR
.RS 4
X screen to use
.RE
.PP
\fB\-d\fR, \fB\-\-display=\fR\fB\fIDISPLAY\fR\fR
.RS 4
X Display to use
.RE
.PP
\fB\-\-sync\fR
.RS 4
Make X calls synchronous
.RE
.PP
\fB\-\-version\fR
.RS 4
Print version and exit
.RE
.PP
\fB\-\-help\fR
.RS 4
Display help and exit
.RE
.PP
\fB\-\-mode=\fR\fB\fIMODE\fR\fR
.RS 4
Use a specific mode, e\&.g\&. "gdm" for login screen
.RE
.PP
\fB\-\-list\-modes\fR
.RS 4
List possible modes and exit
.RE
.PP
\fB\-\-clutter\-display=\fR\fB\fIDISPLAY\fR\fR
.RS 4
Clutter the option display (otherwise ignored)
.RE
.SH "FILES"
.PP
/usr/share/gnome\-session/sessions/gnome\&.session,
/usr/share/applications/org\&.gnome\&.Shell\&.desktop\&.
.SH "BUGS"
.PP
The bug tracker can be reached by visiting the website
\m[blue]\fBhttps://bugzilla\&.gnome\&.org/buglist\&.cgi?product=gnome\-shell\fR\m[]\&. Before sending a bug report, please verify that you have the latest version of gnome\-shell\&. Many bugs (major and minor) are fixed at each release, and if yours is out of date, the problem may already have been solved\&.
.SH "ADDITIONAL INFORMATION"
.PP
For further information, visit the website
\m[blue]\fBhttps://wiki\&.gnome\&.org/Projects/GnomeShell\fR\m[]\&.