info: list adjustment method identifiers

Signed-off-by: Mattias Andrée <maandree@operamail.com>

2 files changed, 65 insertions, 0 deletions

diff --git a/info/libgamma-method-extract b/info/libgamma-method-extract
new file mode 100755
index 0000000..82dce77
--- /dev/null
+++ b/info/libgamma-method-extract
@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+# -*- python -*-
+
+# libgamma — Display server abstraction layer for gamma ramp adjustments
+# Copyright © 2014  Mattias Andrée (maandree@member.fsf.org)
+# 
+# This library is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# This library 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 library.  If not, see <http://www.gnu.org/licenses/>.
+
+import sys
+import os
+
+with open(os.path.dirname(sys.argv[0]) + '/../src/libgamma-method.h', 'rb') as file:
+    data = file.read()
+data = data.decode('utf-8', 'error')
+
+if sys.argv[1] == '--list':
+    if sys.argv[2] == '--method':
+        test1 = lambda line : line.startswith('#define LIBGAMMA_METHOD_')
+        test2 = lambda line : line.split(' ')[1] not in ('LIBGAMMA_METHOD_MAX', 'LIBGAMMA_METHOD_COUNT')
+        test3 = lambda line : not line.endswith('_H')
+        defs = [line for line in data.split('\n') if test1(line) and test2(line) and test3(line)]
+        print('\n'.join([d.split(' ')[1] for d in defs]))
+else:
+    if sys.argv[1] == '--method':
+        i = data.find('\n#define ' + sys.argv[2])
+        data = data[:i]
+        i = data.rfind('\n */')
+        data = data[:i]
+        i = data.rfind('/**\n')
+        data = data[i + len('/**\n'):]
+        data = [line[3:] for line in data.split('\n')]
+        print('\n'.join(data))
+
diff --git a/info/libgamma.texinfo b/info/libgamma.texinfo
index 63e8d71..8bac4b8 100644
--- a/info/libgamma.texinfo
+++ b/info/libgamma.texinfo
@@ -466,6 +466,7 @@ and for the freedom of all.
 @chapter API
 
 @menu
+* Adjustment methods::              Selecting adjustment method.
 * Errors::                          Error codes and how to handle errors.
 @end menu
 
@@ -533,6 +534,26 @@ You may also want to add checks for update to
 
 
 
+@node Adjustment methods
+@section Adjustment methods
+
+@command{libgamma} is an abstraction layer that
+lets you select which display server and protocol
+--- together called adjustment method --- it
+should use to work with the monitors' gamma
+ramps. Supported adjustment method, even if
+excluded at compile-time are identfier by numerical
+values.
+
+@table @code
+£>for method in $(libgamma-method-extract --list --method); do
+@item £{method}
+£>libgamma-method-extract --method $method | texise
+£>done
+@end table
+
+
+
 @node Errors
 @section Errors