Go to file
Florian Müllner 6871b7aa20 docs: Document how to build and run gnome-shell
While we use the standard meson build steps, our dependencies
are non-trivial and running the shell can be tricky; it's
certainly worth documenting.

This is also a good opportunity for plugging out toolbox tooling.

Part-of: <https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/3122>
2024-01-27 22:23:24 +01:00
.gitlab/issue_templates gitlab: Add a comment about disabling extension to the issue template 2022-12-15 19:07:08 +00:00
.gitlab-ci docs: Move HACKING 2024-01-27 22:23:10 +01:00
.settings
data calendar: Stylesheet clean up & fixes 2024-01-26 16:01:37 -03:30
docs docs: Document how to build and run gnome-shell 2024-01-27 22:23:24 +01:00
js iconGrid: Don't recreate StIcons on icon theme changes 2024-01-26 23:36:25 +00:00
lint lint: Remove legacy config 2023-08-09 15:10:38 +00:00
man man: Update options 2020-12-28 02:25:17 +01:00
meson theme: Include both dark and light variant in resource 2023-05-25 17:10:53 +02:00
po Update Galician translation 2024-01-24 00:20:51 +00:00
src st/icon: Automatically update on icon theme changes 2024-01-26 23:36:25 +00:00
subprojects build: Remove dummy gi-docgen dependency 2024-01-26 13:43:28 +00:00
tests util: Handle .rc in version comparisons 2024-01-26 13:20:07 +00:00
tools/toolbox docs: Use consistent spacing 2024-01-27 22:22:11 +01:00
.editorconfig Add .editorconfig 2024-01-25 16:53:36 +00:00
.eslintrc.yml js: Port to modules 2023-08-06 13:02:49 +02:00
.gitignore ci: Simplify run-eslint script 2023-08-09 15:10:38 +00:00
.gitlab-ci.yml ci: Check snippets in coding style 2024-01-27 18:18:23 +00:00
.gitmodules git: Always use libgnome-volume-control submodule from GNOME group 2022-08-04 18:31:16 +02:00
.jscheckignore ci: Don't ignore init.js 2023-04-21 18:28:32 +00:00
config.h.meson shell: Add device monitor for cameras 2023-07-29 13:55:15 +03:00
COPYING
gnome-shell.doap
meson_options.txt shell: Add device monitor for cameras 2023-07-29 13:55:15 +03:00
meson.build build: Remove dummy gi-docgen dependency 2024-01-26 13:43:28 +00:00
NEWS Bump version to 46.alpha 2024-01-07 11:16:54 +01:00
README.md docs: Use consistent spacing 2024-01-27 22:22:11 +01:00

GNOME Shell

GNOME Shell provides core user interface functions for the GNOME 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.

For more information about GNOME Shell, including instructions on how to build GNOME Shell from source and how to get involved with the project, see the project wiki.

Bugs should be reported to the GNOME bug tracking system. Please refer to the Schedule wiki page to see the supported versions.

Contributing

To contribute, open merge requests at https://gitlab.gnome.org/GNOME/gnome-shell.

Commit messages should follow the GNOME commit message guidelines. If a merge request fixes an existing issue, it is good practice to append the full issue URL to each commit message. Try to always prefix commit subjects with a relevant topic, such as panel: or status/network:, and it's always better to write too much in the commit message body than too little.

Default branch

The default development branch is main. If you still have a local checkout under the old name, use:

git checkout master
git branch -m master main
git fetch
git branch --unset-upstream
git branch -u origin/main
git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main

License

GNOME Shell is distributed under the terms of the GNU General Public License, version 2 or later. See the COPYING file for details.