aboutsummaryrefslogtreecommitdiff
path: root/INSTALL.md
diff options
context:
space:
mode:
authorMike Gabriel <mike.gabriel@das-netzwerkteam.de>2021-05-01 22:23:16 +0200
committerMike Gabriel <mike.gabriel@das-netzwerkteam.de>2021-06-07 13:00:41 +0200
commit1aef23ab5fb877b4d70959de9c41e0e385e596b8 (patch)
treef1353f12bc19a2a8ba40504d1b47e28e17a1f9d3 /INSTALL.md
parent479aefda4fdc32b859f2aec396f3f69921472bb6 (diff)
downloadayatana-indicator-session-1aef23ab5fb877b4d70959de9c41e0e385e596b8.tar.gz
ayatana-indicator-session-1aef23ab5fb877b4d70959de9c41e0e385e596b8.tar.bz2
ayatana-indicator-session-1aef23ab5fb877b4d70959de9c41e0e385e596b8.zip
INSTALL.md: Renamed from INSTALL file; adjust to updated test and coverage CMake build options.
Diffstat (limited to 'INSTALL.md')
-rw-r--r--INSTALL.md78
1 files changed, 78 insertions, 0 deletions
diff --git a/INSTALL.md b/INSTALL.md
new file mode 100644
index 0000000..a5fc2f9
--- /dev/null
+++ b/INSTALL.md
@@ -0,0 +1,78 @@
+<!--
+ Copyright (C) 2013 Canonical Ltd
+ Copyright (C) 2017-2021, Mike Gabriel <mike.gabriel@das-netzwerkteam.de>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License version 3 as
+ published by the Free Software Foundation.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+-->
+
+# Build and installation instructions
+
+## Compile-time build dependencies
+
+ - gettext (>= 0.18.1.1-10ubuntu3)
+ - glib2.0 (>= 2.35.4)
+ - optional: liblomiri-url-dispatcher-dev (>= 0.1)
+ - cmake (>= 3.13)
+ - gcovr (>= 2.4)
+ - lcov (>= 1.9)
+ - googletest (>= 1.6.0)
+ - cppcheck
+
+## Runtime DBus dependencies
+
+ - org.ayatana.indicators.webcredentials
+ - org.freedesktop.Accounts
+ - org.freedesktop.Accounts.User
+ - org.freedesktop.DisplayManager.Seat
+ - org.freedesktop.login1.Manager
+ - org.freedesktop.login1.Seat
+ - org.freedesktop.login1.User
+ - org.gnome.ScreenSaver
+ - org.gnome.SessionManager
+ - org.gnome.SessionManager.EndSessionDialog
+
+## For end-users and packagers
+
+```
+cd ayatana-indicator-session-X.Y.Z
+mkdir build
+cd build
+cmake ..
+make
+sudo make install
+```
+
+**The install prefix defaults to `/usr`, change it with `-DCMAKE_INSTALL_PREFIX=/some/path`**
+
+## For testers - unit tests only
+
+```
+cd ayatana-indicator-session-X.Y.Z
+mkdir build
+cd build
+cmake .. -DENABLE_TESTS=ON
+make
+make test
+make cppcheck
+```
+
+## For testers - both unit tests and code coverage
+
+```
+cd ayatana-indicator-session-X.Y.Z
+mkdir build-coverage
+cd build-coverage
+cmake .. -DENABLE_COVERAGE=ON
+make
+make coverage-html
+```