From 224b9501e2fd4e4160b931e71f2e04382e26abee Mon Sep 17 00:00:00 2001
From: Mattias Andrée <maandree@operamail.com>
Date: Wed, 28 May 2014 02:28:54 +0200
Subject: on configuring
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Mattias Andrée <maandree@operamail.com>
---
 info/libgamma.texinfo | 100 +++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 99 insertions(+), 1 deletion(-)

(limited to 'info/libgamma.texinfo')

diff --git a/info/libgamma.texinfo b/info/libgamma.texinfo
index 8f585b6..1860941 100644
--- a/info/libgamma.texinfo
+++ b/info/libgamma.texinfo
@@ -52,6 +52,7 @@ Texts. A copy of the license is included in the section entitled
 
 @menu
 * Overview::                        Brief overview of @command{libgamma}.
+* Compiling::                       Configuring, compiling and installing @command{libgamma}.
 * GNU Free Documentation License::  Copying and sharing this manual.
 @end menu
 
@@ -77,7 +78,9 @@ However Windows GDI and Quartz/CoreGraphics do
 not receive first-party testing on their target
 platforms but do receive first-party testing
 using a compatibility layer that translates
-the calls to RandR calls.
+the calls to RandR calls. Neither does libgamma,
+currently, receive testing on any of the BSD:s,
+it is only tested on GNU/Linux.
 
 Furthermore @command{libgamma} provides a dummy
 method that can be used to ignore adjustments
@@ -88,6 +91,101 @@ such events. It can also be configured at runtime
 to use another adjustment method such as RandR.
 
 
+
+@node Compiling
+@chapter Compiling
+
+The build @command{libgamma} you will need
+to run @command{./configure} before you
+run @command{make}. @file{./configure} is
+not a configuration script from the GNU build
+system, rather it is just a simple shell script.
+Each adjustment method needs selected, if none
+are selected no adjustment method will be compiled
+into @command{libgamma}. They can either be
+selected explicitly and independently or by
+operating system:
+
+@table @option
+@item --enable-dummy
+Enables the dummy adjustment method.
+
+@item --enable-randr
+@itemx --linux
+@itemx --bsd
+Enables the X RandR extension adjustment method.
+
+@item --enable-vidmode
+@itemx --linux
+@itemx --bsd
+Enables the X VidMode extension adjustment method.
+
+@item --enable-drm
+@itemx --linux
+Enables the Direct Rendering Manager adjustment method.
+
+@item --enable-w32gdi
+@itemx --windows
+Enables the Windows GDI adjustment method.
+
+@item --enable-quartz
+@itemx --mac-os-x
+Enables the Quartz/CoreGraphics adjustment method.
+
+@item --enable-w32gdi=fake
+Enables the Windows GDI adjustment method using
+compatibility layer to either RandR or ``/dev/null''
+depending on whether RandR is enabled or not.
+
+@item --enable-quartz=fake
+Enables the Quartz/CoreGraphics adjustment method
+using a compatibility layer to either RandR or
+``/dev/null'' depending on whether RandR is
+enabled or not.
+
+@end table
+
+You may prefix anything to `bsd', for example
+@option{--freebsd} or @option{--openbsd}. Any
+prefix will be discard, but it may be a good
+idea incase there will be a difference in the
+future between the platforms.
+
+Developers of @command{libgamma} and developers
+who use @command{libgamma} for their software may
+also want to use @option{--debug} which enables
+extra checks to produce better error reports.
+Developers can also use the developer options
+instead of @option{--debug}, the adjustment and
+operating systems:
+
+@table @option
+@item --linux=developer
+@itemx --developer
+Enables all adjustment methods, with compatibility
+layers for Windows GDI and Quartz/CoreGraphics.
+Also enables @option{--debug}.
+
+@item --bsd=developer
+Enables all adjustment methods, except the Linux
+Direct Rendering Manager adjustment method, with
+compatibility layers for Windows GDI and
+Quartz/CoreGraphics.
+Also enables @option{--debug}.
+
+@item --windows=developer
+Enables the dummy adjustment method and the
+Windows GDI adjustment method.
+Also enables @option{--debug}.
+
+@item --mac-os-x=developer
+Enables the dummy adjustment method and the
+Quartz/CoreGraphics adjustment method.
+Also enables @option{--debug}.
+@end table
+
+
+
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License
 @include fdl.texinfo
-- 
cgit v1.2.3-70-g09d2