diff --git a/INSTALL b/INSTALL new file mode 100644 index 0000000..7d7dbe3 --- /dev/null +++ b/INSTALL @@ -0,0 +1,35 @@ +## Installation instructions + +SDDM uses CMake to configure and build the project. + + 1. From the project root, create a build directory: `mkdir build` + 2. From the build directory, run cmake to the project root. Eg: `cd build && cmake ..` + 3. To build, run `make`. + 4. To install, run `make install`. + +CMake accepts a number of standard and extra arguments. For example, to build +with Qt 5, append the argument `-DUSE_QT5=true`. +By default, a debug build is created. To build for production, use +`cmake -DCMAKE_BUILD_TYPE=Release`. + +To see all the possible arguments, run `cmake -L ..`. +For documentation on standard CMake variables, see: + http://www.cmake.org/cmake/help/v3.0/manual/cmake-variables.7.html + +### Post-installation steps + +By default, SDDM runs as its own user. An `sddm` user needs to be created, with +its home set to `/var/lib/sddm` by default. + +### Dependencies + +SDDM depends on PAM for authorization and XCB to communicate with the X server. +Apart from other things, it also depends on Qt for the user interface and event +loop management. +SDDM can optionally make use of logind (the systemd login manager API) or +upower to enable support for suspend, hibernate etc. +In order to build the man pages, you will need `rst2man` installed. It is +provided by the python `docutils` package + +Note that SDDM makes use of C++11 features for a modern and clean codebase, +therefore it needs a recent version of GCC to compile (4.7 at least). diff --git a/docs/INSTALL.md b/docs/INSTALL.md deleted file mode 100644 index 71ef7f7..0000000 --- a/docs/INSTALL.md +++ /dev/null @@ -1,30 +0,0 @@ -## Dependencies - -SDDM depends on PAM for authorization and XCB to communicate with the X server. Apart from other things, it also depends on Qt for the user interface and event loop management. SDDM can optionally make use of systemd's login manager (logind) or upower to enable support for suspend, hibernate etc. - -## Compilation - -SDDM uses CMake to configure the build and it can be compiled with the typical cmake build process: - -`mkdir build` - -`cd build` - -`cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local` - -`make` - -After successfully building the software, install it: - -`sudo make install` - -If systemd is found during the build, it will be used for power management. Otherwise, the build will fallback to upower. If upower can't be found either, shutdown/reboot/suspend/hibernate actions won't be available. -Note that, when systemd is used, the HaltCommand and RebootCommand config file entries have no effect. - -SDDM by default uses Qt4. If you want to use Qt5 instead, simply add `-DUSE_QT5=true` at the end of the cmake line. Qt5 unlocks some additional capabilities for the themes like hardware acceleration, mouse cursors etc. - -Note that SDDM uses certain C++11 features for a modern and clean codebase, therefore it needs `gcc >= 4.7` to compile. - -## Configuration - -After installation, the file `sddm.conf` can be used to configure sddm. Options in the config file are mostly self explanatory, but the sample config file, by default named `sddm.conf.sample` can also be used as a reference as it contains comments for each individual option.