brl/gnome-shell
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Read-only mirror of https://gitlab.gnome.org/GNOME/gnome-shell
18,564 Commits 180 Branches 237 Tags 70 MiB
C 49.2%
JavaScript 47.4%
SCSS 1.4%
Meson 0.8%
Python 0.6%
Other 0.4%
a27ba309dd
Go to file
Florian Müllner a27ba309dd tools/toolbox: Expose --reconfigure meson flag 
It turns out that nowadays meson updates don't always require
a full wipe of an existing build dir, but `--reconfigure` is
often enough. So let's expose that flag as well.

Part-of: <https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/3187>
2024-02-12 13:48:00 +00: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 Clean out some eclipse artefacts 2019-02-13 04:39:26 +01:00
data screencastService: Propagate machine-parseable error types to gnome-shell 2024-02-11 11:32:19 +01:00
docs docs: Split commit message conventions from README 2024-01-27 22:23:24 +01:00
js screencastService: Remove unused variable assignment 2024-02-11 12:36:23 +01: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 Georgian translation 2024-02-12 13:00:59 +00:00
src window tracker: Adapt to renamed function 2024-02-08 16:45:06 +01:00
subprojects Bump version to 46.beta 2024-02-11 17:54:00 +01:00
tests notification: Use the same Source for showing system notifications 2024-02-06 17:25:01 +00:00
tools/toolbox tools/toolbox: Expose --reconfigure meson flag 2024-02-12 13:48:00 +00: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: Bump mutter image 2024-02-11 02:15:34 +01: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 gnome-shell.doap: Make marge-bot a maintainer 2020-11-17 17:29:56 +00:00
meson_options.txt shell: Add device monitor for cameras 2023-07-29 13:55:15 +03:00
meson.build Bump version to 46.beta 2024-02-11 17:54:00 +01:00
NEWS Bump version to 46.beta 2024-02-11 17:54:00 +01:00
README.md docs: List additional docs and API references in README 2024-01-27 22:23:24 +01:00

README.md

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.

All interactions with the project should follow the Code of Conduct.

Supported versions

Upstream gnome-shell only supports the most recent stable release series, the previous stable release series, and the current development release series. Any older stable release series are no longer supported, although they may still receive backported security updates in long-term support distributions. Such support is up to the distributions, though.

Please refer to the schedule to see when a new version will be released.

Reporting bugs

Bugs should be reported to the issue tracking system.

The GNOME handbook has useful information for creating effective issue reports.

If you are using extensions, please confirm that an issue still happens without extensions. To properly disable extensions you can use the extensions-app and then restart your session. Disabling extensions without a restart is not sufficient to rule out extensions as the cause of a bug. If an issue can only be reproduced with a certain extension, please file an issue report against that extension first.

Please note that the issue tracker is meant to be used for actionable issues only.

For support questions, feedback on changes or general discussions, you can use:

Feature requests

gnome-shell is a core compoment of the GNOME desktop experience. As such, any changes in behavior or appearance only happen in accordance with the GNOME design team.

For major changes, it is best to start a discussion on discourse and reach out on the #gnome-design matrix room, and only involve the issue tracker once agreement has been reached.

In particular mockups must be approved by the design team to be considered for implementation.

For enhancements that are limited in scope and well-defined, it is acceptable to directly open a feature request.

When in doubt, it is better to ask before opening an issue.

Contributing

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

It can be useful to first look at the GNOME handbook.

If a change likely requires discussion beyond code review, it is probably better to open an issue first, or follow the process for feature requests. Otherwise, creating a separate issue is not required.

The following guidelines will help your change to be successfully merged:

  • Keep the change as small as possible. If you can split it into multiple merge requests, please do so.
  • Use multiple commits. This makes it easier to review and helps to diagnose bugs in the future.
  • Use clear commit messages following the conventions.
  • Pay attention to the CI results. Merge requests cannot be merged until the CI passes.

Documentation

API Reference

  • Meta: Display server and window manager
  • St: Shell toolkit
  • Clutter: OpenGL based scene graph
  • Shell: Non-ui shell objects and utilities
  • See the mutter page for additional documentation

License

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