summaryrefslogtreecommitdiff
path: root/README.md
blob: d7bf7897ec63f454794d8f3e23af5ddc8fa063af (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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
# logdiag

logdiag is a simple multiplatform schematic editor written in GTK+.

__This software is considered to be of alpha quality and isn't recommended for
regular usage.__

## Requirements

Runtime dependencies:

 - GTK+ >= 3.8
 - json-glib >= 0.10.4
 - lua = 5.2

Build dependencies:

 - CMake >= 2.8

## Installation from sources on Unix-like systems

First check that you have all the required dependencies installed, including
all development packages, if your distribution provides them.

Reserve a directory for an out-of-source build:

    $ mkdir build
    $ cd build

Let CMake prepare the build. You may change the directory where you want the
application to be installed. The default is _/usr/local_.

    $ cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr

Now you have two basic choices of installing the application.

#### Using _make install_

    # make install

#### Using _cpack_

You have to choose a package format understood by your system package manager.
CMake offers DEB and RPM.

After _cpack_ finishes making the package, install this file.

    $ fakeroot cpack -G DEB
    # dpkg -i logdiag-version-system-arch.deb

Leave out the fakeroot for CMake >= 2.8.9, it's been fixed since.

## Building from sources on Windows

First install CMake >= 3.1 and MinGW. Add both to your system path. If you want
to build an installation package, also install NSIS.

Run the following command in the directory with source files to automatically
fetch and setup all dependencies (contact me if the script becomes obsolete,
it's easy to fix but I usually update it only just a short while before
releasing a new version in order to resolve compatibility issues):

    > cmake -P Win32Depends.cmake

Reserve a directory for an out-of-source build:

    > mkdir build
    > cd build

Let CMake prepare the build:

    > cmake .. -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release

Now you can generate a package with CPack. You may choose between:

1. An NSIS-based installation package:

    > cpack -G NSIS

2. A portable ZIP package:

    > cpack -G ZIP

By default, that is if you specify no generator, both packages are built.

## Cross-compiling for Windows

The procedure is almost exactly the same as before, including the requirements.
Just install MinGW-w64 and let automation take care of the rest.

    $ cmake -P Win32Depends.cmake
    $ mkdir build
    $ cd build
    $ cmake .. \
      -DCMAKE_TOOLCHAIN_FILE=../ToolchainDebianMinGWW64.cmake \
      -DCMAKE_BUILD_TYPE=Release
    $ cpack