aboutsummaryrefslogtreecommitdiffstats
path: root/info
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--info/libgamma.texinfo100
1 files changed, 99 insertions, 1 deletions
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