gnome-shell/man/gnome-shell.rst
Florian Müllner ad448533cb man: Use .rst suffix for sources
It's more common to use the dedicated .rst suffix for reStructuredText
files, so now that the files were ported,
use that.

(Renaming the files separately from changing it is less likely
to confuse git, thus the separate commit)

Part-of: <https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/3454>
2024-08-28 19:49:45 +00:00

110 lines
2.3 KiB
ReStructuredText

===========
gnome-shell
===========
-------------------------------------
Graphical shell for the GNOME desktop
-------------------------------------
:Manual section: 1
:Manual group: User Commands
SYNOPSIS
--------
**gnome-shell** [*OPTION*...]
DESCRIPTION
-----------
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.
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.
OPTIONS
-------
``--wayland``
Run as a wayland compositor
``--display-server``
Run as a full display server, rather than nested
``--nested``
Run as a nested compositor
``--no-x11``
Run wayland compositor without starting Xwayland
``--x11``
Run with X11 backend
``--wayland-display``\ =\ *DISPLAY*
Wayland display name to use
``-d``, ``--display``\ =\ *DISPLAY*
X display to use
``-r``, ``--replace``
Replace the running window manager
``--sm-disable``
Disable connection to the session manager
``--sm-client-id``\ =\ *ID*
Specify session management *ID*
``--sm-save-file``\ =\ *FILE*
Initialize session from *FILE*
``--sync``
Make X calls synchronous
``--mode=MODE``
Use a specific mode, e.g. "gdm" for login screen
``--list-modes``
List possible modes and exit
``--version``
Print version and exit
``--help``
Display help and exit
FILES
-----
/usr/share/gnome-session/sessions/gnome.session,
/usr/share/applications/org.gnome.Shell.desktop.
BUGS
----
The bug tracker can be reached by visiting the website
https://gitlab.gnome.org/GNOME/gnome-shell/issues.
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.
ADDITIONAL INFORMATION
----------------------
For further information, visit the website https://gitlab.gnome.org/GNOME/gnome-shell/-/blob/main/README.md.