mirror of
https://github.com/brl/mutter.git
synced 2024-11-12 17:27:03 -05:00
Add MarkDown version of the README
This commit is contained in:
parent
9753046ca0
commit
4333507b50
175
README.md
Normal file
175
README.md
Normal file
@ -0,0 +1,175 @@
|
||||
Clutter
|
||||
=======
|
||||
|
||||
What it Clutter?
|
||||
----------------
|
||||
|
||||
Clutter is an open source software library for creating fast, compelling,
|
||||
portable, and dynamic graphical user interfaces.
|
||||
|
||||
Requirements
|
||||
------------
|
||||
|
||||
Clutter currently requires:
|
||||
|
||||
* [GLib](http://git.gnome.org/browse/glib)
|
||||
* [JSON-GLib](http://git.gnome.org/browse/json-glib)
|
||||
* [Atk](http://git.gnome.org/browse/atk)
|
||||
* [Cairo](http://cairographics.org)
|
||||
* [Pango](http://git.gnome.org/browse/pango)
|
||||
* [OpenGL ≥ 1.3 (or 1.2 + multitexturing), or OpenGL ES 2.0 (or 1.1)](http://khronos.org)
|
||||
* GLX, AGL, WGL or an EGL implementation
|
||||
|
||||
Clutter also has optional dependencies:
|
||||
|
||||
* [GDK-Pixbuf](http://git.gnome.org/browse/gdk-pixbuf)
|
||||
|
||||
On X11, Clutter depends on the following extensions:
|
||||
|
||||
* XComposite
|
||||
* XDamage
|
||||
* XExt
|
||||
* XFixes
|
||||
* XInput (1.x or 2.x)
|
||||
* XKB
|
||||
|
||||
If you are building the API reference you will also need:
|
||||
|
||||
* [GTK-Doc](http://git.gnome.org/browse/gtk-doc)
|
||||
|
||||
If you are building the additional documentation you will also need:
|
||||
|
||||
* xsltproc
|
||||
* jw (optional, for generating PDFs)
|
||||
|
||||
If you are building the Introspection data you will also need:
|
||||
|
||||
* [GObject-Introspection](http://git.gnome.org/browse/gobject-introspection)
|
||||
|
||||
If you want support for profiling Clutter you will also need:
|
||||
|
||||
* [UProf](git://github.com/rib/UProf.git)
|
||||
|
||||
Resources
|
||||
---------
|
||||
|
||||
The official Clutter website is:
|
||||
|
||||
http://www.clutter-project.org/
|
||||
|
||||
The API references for the latest stable release are available at:
|
||||
|
||||
http://docs.clutter-project.org/docs/clutter/stable/
|
||||
http://docs.clutter-project.org/docs/cogl/stable/
|
||||
http://docs.clutter-project.org/docs/cally/stable/
|
||||
|
||||
The Clutter Cookbook is available at:
|
||||
|
||||
http://docs.clutter-project.org/docs/clutter-cookbook/
|
||||
|
||||
New releases of Clutter are available at:
|
||||
|
||||
http://source.clutter-project.org/sources/clutter/
|
||||
|
||||
The Clutter blog is available at:
|
||||
|
||||
http://www.clutter-project.org/blog/
|
||||
|
||||
To subscribe to the Clutter mailing lists and read the archives, use the
|
||||
Mailman web interface available at:
|
||||
|
||||
http://lists.clutter-project.org/
|
||||
|
||||
New bug page on Bugzilla:
|
||||
|
||||
http://bugzilla.clutter-project.org/enter_bug.cgi?product=clutter
|
||||
http://bugzilla.clutter-project.org/enter_bug.cgi?product=cogl
|
||||
|
||||
Clutter is licensed under the terms of the GNU Lesser General Public
|
||||
License, version 2.1 or (at your option) later: see the `COPYING` file
|
||||
for more information.
|
||||
|
||||
Building and Installation
|
||||
-------------------------
|
||||
|
||||
To build Clutter from a release tarball, the usual autotool triad should
|
||||
be followed:
|
||||
|
||||
1. ./configure
|
||||
2. make
|
||||
3. make install
|
||||
|
||||
To build Clutter from a Git clone, run the autogen.sh script instead
|
||||
of the configure one. The `autogen.sh` script will run the configure script
|
||||
for you, unless the `NOCONFIGURE` environment variable is set to a non-empty
|
||||
value.
|
||||
|
||||
See also the [BuildingClutter][building-clutter] page on the wiki.
|
||||
|
||||
Versioning
|
||||
----------
|
||||
|
||||
Clutter uses the common "Linux kernel" versioning system, where
|
||||
even-numbered minor versions are stable and odd-numbered minor
|
||||
versions are development snapshots.
|
||||
|
||||
Different major versions break both API and ABI but are parallel
|
||||
installable. The same major version with differing minor version is
|
||||
expected to be ABI compatible with other minor versions; differing
|
||||
micro versions are meant just for bug fixing. On odd minor versions
|
||||
the newly added API might still change.
|
||||
|
||||
The micro version indicates the origin of the release: even micro
|
||||
numbers are only used for released archives; odd micro numbers are
|
||||
only used on the Git repository.
|
||||
|
||||
Contributing
|
||||
------------
|
||||
|
||||
If you want to hack on and improve Clutter check the `HACKING` file for
|
||||
general implementation guidelines, and the `HACKING.backends` for
|
||||
backend-specific implementation issues.
|
||||
|
||||
The `CODING_STYLE` file contains the rules for writing code conformant to
|
||||
the style guidelines used throughout Clutter. Remember: the coding style
|
||||
is mandatory; patches not conforming to it will be rejected by default.
|
||||
|
||||
The usual workflow for contributions should be:
|
||||
|
||||
1. Fork the repository
|
||||
2. Create a branch (`git checkout -b my_work`)
|
||||
3. Commit your changes (`git commit -am "Added my awesome feature"`)
|
||||
4. Push to the branch (`git push origin my_work`)
|
||||
5. Create an [Issue][1] with a link to your branch
|
||||
6. Sit back, relax and wait for feedback and eventual merge
|
||||
|
||||
Bugs
|
||||
----
|
||||
|
||||
Bugs should be reported to the Clutter Bugzilla at:
|
||||
|
||||
http://bugzilla.clutter-project.org/enter_bug.cgi?product=clutter
|
||||
http://bugzilla.clutter-project.org/enter_bug.cgi?product=cogl
|
||||
|
||||
You will need a Bugzilla account.
|
||||
|
||||
In the report you should include:
|
||||
|
||||
* what system you're running Clutter on;
|
||||
* which version of Clutter you are using;
|
||||
* which version of GLib and OpenGL (or OpenGL ES) you are using;
|
||||
* which video card and which drivers you are using, including output of
|
||||
glxinfo and xdpyinfo (if applicable);
|
||||
* how to reproduce the bug.
|
||||
|
||||
If you cannot reproduce the bug with one of the tests that come with Clutter
|
||||
source code, you should include a small test case displaying the bad
|
||||
behaviour.
|
||||
|
||||
If the bug exposes a crash, the exact text printed out and a stack trace
|
||||
obtained using gdb are greatly appreciated.
|
||||
|
||||
|
||||
|
||||
[building-clutter]: http://wiki.clutter-project.org/wiki/BuildingClutter
|
||||
[1]: http://github.com/clutter-project/clutter/issues
|
Loading…
Reference in New Issue
Block a user