summaryrefslogtreecommitdiff
path: root/README.md
blob: 87a61dfde5117f4ee87e3918a41491d38745972b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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
52
53
54
55
56
57
58
59
60
61
62
63
Open Endless SDK
================

Libraries and development tools for building Endless applications.

Coding style
------------

We follow the GTK coding style:
https://git.gnome.org/browse/gtk+/plain/docs/CODING-STYLE

Build instructions
------------------

Run `make` anytime you change a file.

Preparing the source
--------------------

From a fresh source checkout, run:

    ./autogen.sh
    ./configure

This prepares the source tree for building. The `configure` script takes several options, common ones being:

 - `--prefix=/usr`: install in `/usr` instead of `/usr/local` (you probably want this)
 - `--enable-gtk-doc`: generate the documentation whenever you build; this makes your build slower, but the documentation will always be up to date
 - `--enable-strict-flags`: use strict compiler flags to catch extra warnings
 - If you're doing a debug build, then `CFLAGS="-g -O0" ./configure` will make sure that `make` always builds with debugging symbols and optimization off.

Then, run `make` to rebuild, and `sudo make install` to copy the SDK into the system.

By default, the compiler invocations with all the flags are not shown.
If you want to see them, run `make V=1`.
If you want make to try and run several jobs in parallel, run `make -j2` for 2 jobs, for example.

Testing
-------

To run the automated tests, run `make check`.

Packaging
---------

Before packaging, run `make distcheck`.
This runs the tests as above, but from a clean source tree in a temporary location.
It also installs all the files in a temporary location and uninstalls them again, in order to make sure that nothing is forgotten.

Fixing breakage
---------------

If at any time the state of your build tree gets wedged, then try the following:

    make clean
    make

If that doesn't work,

    make maintainer-clean
    ./autogen.sh
    ./configure
    make