README.md 2.35 KB
Newer Older
Claudio André's avatar
Claudio André committed
1
[![Build Status](https://gitlab.gnome.org/GNOME/gnome-control-center/badges/master/build.svg)](https://gitlab.gnome.org/GNOME/gnome-control-center/pipelines)
Claudio André's avatar
Claudio André committed
2
[![Coverage report](https://gitlab.gnome.org/GNOME/gnome-control-center/badges/master/coverage.svg)](https://gnome.pages.gitlab.gnome.org/gnome-control-center/)
Claudio André's avatar
Claudio André committed
3
4
[![License](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://gitlab.gnome.org/GNOME/gnome-control-center/blob/master/COPYING)

5
GNOME Settings
6
7
====================

Pavlin Georgiev's avatar
Pavlin Georgiev committed
8
GNOME Settings is GNOME's main interface for configuration of various aspects of your desktop.
9

10
## Contributing
11

12
13
See `docs/CONTRIBUTING.md` for details on the contribution process, and `docs/HACKING.md`
for the coding style guidelines.
14

15
## Reporting Bugs
16

17
18
Before reporting any bugs or opening feature requests, [read the communication guidelines][communication-guidelines].

19
Bugs should be reported to the GNOME bug tracking system under the product
20
gnome-control-center. It is available at [GitLab Issues](https://gitlab.gnome.org/GNOME/gnome-control-center/issues).
21

Pavlin Georgiev's avatar
Pavlin Georgiev committed
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
In the report please include the following information:

 * Operating system and version
 * For Linux, version of the C library
 * Exact error message
 * Steps to reproduce the bug
 * If the bug is a visual defect, attach a screenshot
 * If the bug is a crash, attach a backtrace if possible [see below]

### How to get a backtrace

If the crash is reproducible, follow the steps to obtain a 
backtrace:

Install debug symbols for gnome-control-center.

Run the program in gdb [the GNU debugger] or any other debugger.

    gdb gnome-control-center

Start the program.
    
    (gdb) run

Reproduce the crash and when the program exits to (gdb) prompt, get the backtrace.

    (gdb) bt full

Once you have the backtrace, copy and paste it into the 'Comments' field or attach it as
a file to the bug report.
52
53
54
55
56
57
58
59
60
61
62
63

## Testing Unstable Settings

It is quite easy to test and give feedback about the development version of GNOME
Settings. Just access https://gitlab.gnome.org/GNOME/gnome-control-center/environments,
get the latest version, download it, double-click the file, install and run.

Note that GNOME Settings Flatpak will only work if you are running
the latest GNOME version in your host system.


[communication-guidelines]: https://gitlab.gnome.org/GNOME/gnome-control-center/blob/master/docs/CONTRIBUTING.md#communication-guidelines