README

MATE Control Center
====================

About -

The control center is MATE's main interface for configuration of various
aspects of your desktop.

Installation -

./autogen.sh
make
make install

How to report bugs -

Bugs should be reported to the MATE bug tracking system under github:
	https://github.com/mate-desktop/mate-control-center/issues

In the report please include the following information -

	Operating system and version
	For Linux, version of the C and glib libraries
	How to reproduce the bug if possible
	If the bug was a crash, include the exact text that was printed out
	A stacktrace where possible [see below]

How to get a stack trace -

If the crash is reproducible, it is possible to get a stack trace and
attach it to the bug report. The following steps are used to obtain a
stack trace -

	Run the program in gdb [the GNU debugger] or any other debugger
		ie. gdb mate-keyboard-properties
	Start the program
		ie. (gdb) run
	Reproduce the crash and the program will exit to the gdb prompt
	Get the back trace
		ie. (gdb) bt full

Once you have the backtrace, copy and paste this either into the
'Comments' field or attach a file with it included.


Patches -

Patches should be submitted to github as pull requests:
	https://github.com/mate-desktop/mate-control-center/pulls
	https://help.github.com/articles/fork-a-repo
	https://help.github.com/articles/using-pull-requests