Difference between revisions of "Developer's corner"

From GCompris
Jump to: navigation, search
(added compilation instructions)
(added mailing list and chat)
Line 2: Line 2:
  
 
To fill a bug report for GCompris, you must use the [http://bugzilla.gnome.org/query.cgi gnome bugzilla] and select GCompris in the product list.
 
To fill a bug report for GCompris, you must use the [http://bugzilla.gnome.org/query.cgi gnome bugzilla] and select GCompris in the product list.
 +
 +
== Mailing list ==
 +
 +
You can join and browse the [https://lists.sourceforge.net/lists/listinfo/gcompris-devel GCompris mailing list].
 +
 +
This mailing list is used by the developers and users willing to stay aware of what’s going on. You will get new release announcements. Users can join the list and report bugs, discuss feature they would like to have, ...
 +
 +
The language is English. There is also a user mailing list in [https://lists.sourceforge.net/lists/listinfo/gcompris-france French] and in [https://lists.sourceforge.net/lists/listinfo/gcompris-portugues Portuguese]. If you want to create a user list in your language, please contact me (bruno.coudoin@gcompris.net).
 +
 +
== Chat ==
 +
 +
You can enter in contact with the users and developers of [http://en.wikipedia.org/wiki/IRC GCompris on IRC]. The server is irc.freenode.net on the channel #gcompris.
 +
 +
To join an IRC server, you can use the [http://www.xchat.org/ excellent xchat software].
  
 
== Branches ==
 
== Branches ==

Revision as of 11:59, 7 September 2013

How to report a bug

To fill a bug report for GCompris, you must use the gnome bugzilla and select GCompris in the product list.

Mailing list

You can join and browse the GCompris mailing list.

This mailing list is used by the developers and users willing to stay aware of what’s going on. You will get new release announcements. Users can join the list and report bugs, discuss feature they would like to have, ...

The language is English. There is also a user mailing list in French and in Portuguese. If you want to create a user list in your language, please contact me (bruno.coudoin@gcompris.net).

Chat

You can enter in contact with the users and developers of GCompris on IRC. The server is irc.freenode.net on the channel #gcompris.

To join an IRC server, you can use the excellent xchat software.

Branches

We use git for our development. The git repository is hosted by Gnome but we also have a local web viewer.

To get the GCompris master branch (warning this takes more than 500MB) :

git clone git://git.gnome.org/gcompris
cd gcompris
sh autogen.sh && make

Alternatively, if you are only interested in the recent history, and would want to send in fixes as patches, you can use the option: git clone --depth=1 git://git.gnome.org/gcompris. It will save you more than 100MB.

Dependencies

GCompris has a lot of dependencies. On a Debian based distribution that already packages GCompris, you can install all the required dependencies with the command 'apt-get build-dep gcompris'.

Compilation

Download the archive gcompris-X.X.tar.gz or get it from git then:

  • tar -xvf gcompris-X.X.tar.gz
  • cd gcompris-X.X
  • sh configure

Analyse, the errors, install the missing dependancies. Often you will have to install the -devel packages on your distribution. On Ubuntu or Debian, you can get all the build dependancies with the command ’apt-get build-dep gcompris’.

Then run:

  • make
  • make install

Documentation

The Drawing board

These are pages to hold the different discussion for things we are working on:

Translations

Packagers

GCompris is a large software which has numerous dependencies. We ask packagers to be very careful and follow this minimal and manual test process.