====== Xfce Screensaver Building & Installation ======

This document provides information about building and installing xfce4-screensaver.\\
Please [[https://bugzilla.xfce.org/enter_bug.cgi?product=Xfce4-screensaver&component=General|report a bug]] for any changes or distribution-specific additions.

===== Build Requirements =====

  * dbus-glib 0.30
  * garcon-gtk3 0.5.0
  * glib 2.50.0
  * gtk 3.22.0
  * libxklavier 5.2
  * libxfce4ui 4.12.1
  * libxfce4util 4.12.1
  * xfconf 4.12.1
  * xrandr 1.3
  * xscrnsaver
  * x11 1.0

===== Instructions =====

==== From Source (GIT) ====

<code>
./autogen.sh <configuration parameters>
make && sudo make install
</code>

==== From Source (Release) ====

<code>
./configure <configuration parameters>
make && sudo make install
</code>

==== Source Configuration Parameters ====

Please run ''./configure --help'' to learn more about how to configure your build of xfce4-screensaver. The parameters listed below are made available as a secondary reference.

**''Installation Directories''**

^ Option ^ Description ^ Default ^
| --prefix=PREFIX | install architecture-independent files in PREFIX | /usr/local |
| --exec-prefix=EPREFIX | install architecture-dependent files in EPREFIX | PREFIX |
| --bindir=DIR | user executables | EPREFIX/bin |
| --sbindir=DIR | system admin executables | EPREFIX/sbin |
| --libexecdir=DIR | program executables | EPREFIX/libexec |
| --sysconfdir=DIR | read-only single-machine data | PREFIX/etc |
| --sharedstatedir=DIR | modifiable architecture-independent data | PREFIX/com |
| --localstatedir=DIR | modifiable single-machine data | PREFIX/var |
| --runstatedir=DIR | modifiable per-process data | LOCALSTATEDIR/run |
| --libdir=DIR | object code libraries | EPREFIX/lib |
| --includedir=DIR | C header files | PREFIX/include |
| --oldincludedir=DIR | C header files for non-gcc | /usr/include |
| --datarootdir=DIR | read-only arch.-independent data root | PREFIX/share |
| --datadir=DIR | read-only architecture-independent data | DATAROOTDIR |
| --infodir=DIR | info documentation | DATAROOTDIR/info |
| --localedir=DIR | locale-dependent data | DATAROOTDIR/locale |
| --mandir=DIR | man documentation | DATAROOTDIR/man |
| --docdir=DIR | documentation root | DATAROOTDIR/doc/xfce4-screensaver |
| --htmldir=DIR | html documentation | DOCDIR |
| --dvidir=DIR | dvi documentation | DOCDIR |
| --pdfdir=DIR | pdf documentation | DOCDIR |
| --psdir=DIR | ps documentation | DOCDIR |

**''Program Names''**

^ Option ^ Description ^ Default ^
| --program-prefix=PREFIX | prepend PREFIX to installed program names | |
| --program-suffix=SUFFIX | append SUFFIX to installed program names | |
| --program-transform-name=PROGRAM | run sed PROGRAM on installed program names | |

**''X Features''**

^ Option ^ Description ^ Default ^
| --x-includes=DIR | X include files are in DIR | |
| --x-libraries=DIR | X library files are in DIR | |

**''System Types''**

^ Option ^ Description ^ Default ^
| --build=BUILD | configure for building on BUILD | guessed |
| --host=HOST | cross-compile to build programs to run on HOST | BUILD |

**''Optional Features''**

^ Option ^ Description ^ Default ^
| --disable-option-checking | ignore unrecognized --enable/--with options | |
| --disable-FEATURE | do not include FEATURE (same as --enable-FEATURE=no) | |
| --enable-FEATURE[=ARG] | include FEATURE [ARG=yes] | |
| --enable-silent-rules | less verbose build output (undo: "make V=1") | |
| --disable-silent-rules | verbose build output (undo: "make V=0") | |
| --enable-maintainer-mode | enable make rules and dependencies not useful (and sometimes confusing) to the casual installer | |
| --disable-nls | do not use Native Language Support | |
| --enable-dependency-tracking | do not reject slow dependency extractors | |
| --disable-dependency-tracking | speeds up one-time build | |
| --enable-shared[=PKGS] | build shared libraries | yes |
| --enable-static[=PKGS] | build static libraries | yes |
| --enable-fast-install[=PKGS] | optimize for fast installation | yes |
| --disable-libtool-lock | avoid locking (might break parallel builds) | |
| --disable-schemas-compile | Disable regeneration of gschemas.compiled on install | |
| --enable-docbook-docs | build documentation (requires xmlto) | |

**''Screen Locking Options''**

^ Option ^ Description ^ Default ^
| --enable-locking | Compile in support for locking the display. | |
| --disable-locking | Do not allow locking at all. | |
| --enable-pam | Enable PAM support | auto |
| --enable-authentication-scheme=auto/pam/helper/pwent/bsdauth | Choose a specific authentication scheme | auto |
| --enable-more-warnings | Maximum compiler warnings | |
| --enable-debug=no/yes | turn on debugging | |

**''Optional Packages''**

^ Option ^ Description ^ Default ^
| --with-PACKAGE[=ARG] | use PACKAGE [ARG=yes] | |
| --without-PACKAGE | do not use PACKAGE (same as --with-PACKAGE=no) | |
| --with-pic[=PKGS] | try to use only PIC/non-PIC objects | use both |
| --with-aix-soname=<aix, svr4, both> | shared library versioning (aka "SONAME") variant to provide on AIX | aix |
| --with-gnu-ld | assume the C compiler uses GNU ld | no |
| --with-sysroot[=DIR] | Search for dependent libraries within DIR (or the compiler's sysroot if not specified). | |
| --with-x | use the X Window System | |
| --with-pam-prefix=<prefix> | specify where pam files go | |
| --with-pam-auth-type=<auth-type> | specify pam auth type (common or system) | guessed |
| --with-doc-dir=<dir> | directory to install documentation | |
| --with-mit-ext | Include support for the MIT-SCREEN-SAVER extension. | |
| --with-xf86gamma-ext | Include support for XFree86 gamma fading. | |
| --with-xscreensaverdir=dir | Use xscreensaver hack configs found in directory | |
| --with-xscreensaverhackdir=dir | Look for xscreensaver hack executables in directory | |
| --with-libgl | build with GL support | |
| --with-shadow | Include support for shadow password authentication. | |
| --with-passwd-helper | Include support for an external password verification helper program. | |
| --with-console-kit | Add ConsoleKit support | |
| --with-systemd | Add systemd support | |
| --without-kbd-layout-indicator | disable keyboard layout indicator | |

**''Influential Environment Variables''**

^ Variable ^ Description ^
| CC | C compiler command |
| CFLAGS | C compiler flags |
| LDFLAGS | linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir> |
| LIBS | libraries to pass to the linker, e.g. -l<library> |
| CPPFLAGS | (Objective) C/C++ preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir> |
| CPP | C preprocessor |
| LT_SYS_LIBRARY_PATH | User-defined run-time library search path. |
| PKG_CONFIG | path to pkg-config utility |
| PKG_CONFIG_PATH | directories to add to pkg-config's search path |
| PKG_CONFIG_LIBDIR | path overriding pkg-config's built-in search path |
| XFCE_SCREENSAVER_CFLAGS | C compiler flags for XFCE_SCREENSAVER, overriding pkg-config |
| XFCE_SCREENSAVER_LIBS | linker flags for XFCE_SCREENSAVER, overriding pkg-config |
| XFCE_SCREENSAVER_DIALOG_CFLAGS | C compiler flags for XFCE_SCREENSAVER_DIALOG, overriding pkg-config |
| XFCE_SCREENSAVER_DIALOG_LIBS | linker flags for XFCE_SCREENSAVER_DIALOG, overriding pkg-config |
| XFCE_SCREENSAVER_CAPPLET_CFLAGS | C compiler flags for XFCE_SCREENSAVER_CAPPLET, overriding pkg-config |
| XFCE_SCREENSAVER_CAPPLET_LIBS | linker flags for XFCE_SCREENSAVER_CAPPLET, overriding pkg-config |
| XFCE_SCREENSAVER_COMMAND_CFLAGS | C compiler flags for XFCE_SCREENSAVER_COMMAND, overriding pkg-config |
| XFCE_SCREENSAVER_COMMAND_LIBS | linker flags for XFCE_SCREENSAVER_COMMAND, overriding pkg-config |
| XFCE_SCREENSAVER_SAVER_CFLAGS | C compiler flags for XFCE_SCREENSAVER_SAVER, overriding pkg-config |
| XFCE_SCREENSAVER_SAVER_LIBS | linker flags for XFCE_SCREENSAVER_SAVER, overriding pkg-config |
| XMKMF | Path to xmkmf, Makefile generator for X Window System |
| SYSTEMD_CFLAGS | C compiler flags for SYSTEMD, overriding pkg-config |
| SYSTEMD_LIBS | linker flags for SYSTEMD, overriding pkg-config |