From 3f36f82f2bf77ff36e7f4eccefc2ad595a8078d3 Mon Sep 17 00:00:00 2001
From: Mattias Andrée <maandree@operamail.com>
Date: Wed, 19 Feb 2014 13:29:48 +0100
Subject: misc + partial info chapter: invoking
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/blueshift.texinfo | 87 +++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 86 insertions(+), 1 deletion(-)

(limited to 'info/blueshift.texinfo')

diff --git a/info/blueshift.texinfo b/info/blueshift.texinfo
index 9698ae6..e389c5c 100644
--- a/info/blueshift.texinfo
+++ b/info/blueshift.texinfo
@@ -89,12 +89,97 @@ calls to any system dependent functions.
 If Blueshift does not work for you for any of these
 reasons, you should take a look at Redshift.
 
-Blueshift is fully extensible and highly configurable.
 
 
 @node Invoking
 @chapter Invoking
 
+Blueshift uses argparser to read options from the
+commnad line. It inherits a few properaties from this:
+abbreviations are supported, you only need to type the
+beginning of the long options so that the rest can
+be filled in unambiguously by the program; @option{--}
+can be used, as usual, to make all following options
+being parsed as just arguments; and @option{++} works
+like @option{--}, except it only allied to the next
+option. Any argument that is not parsed as an option
+for Blueshift is passed onto the configuration script.
+
+Blueshift recognises the following options:
+
+@table @option
+@item -c
+@itemx --configurations FILE
+Select configuration script. This defaults to the
+first file of the following the exists:
+@file{$XDG_CONFIG_HOME/blueshift/blueshiftrc},
+@file{$HOME/.config/blueshift/blueshiftrc},
+@file{$HOME/.blueshiftrc}, @file{/etc/blueshiftrc}.
+Blueshift does not check the user home, rather it
+checks @env{HOME} which should be the user home, unless
+you change it yourself.
+
+@item -p @c the long name of option is inspired from openntpd
+@itemx --panic-gate
+@itemx --panicgate
+Applies the settings directly instead of transitioning
+into the initial settings. There is not option for doing
+this when the program exists. But you press @kbd{Control+c}
+twice, or send SIGTERM twice, to skip transition into
+default settings.
+
+@item -h
+@itemx -?
+@itemx --help
+Prints help information.
+
+@item -C
+@itemx --copying
+@itemx --copyright
+Prints copyright information.
+
+@itemx -W
+@itemx --warranty
+Prints non-warranty information,
+included in the copyright information.
+
+@itemx -v
+@itemx --version
+Prints the name of the program and the
+installed version of the program
+@end table
+
+Blueshift also supports a few options
+for ad-hoc settings. These are ignored
+(unlessed fetched by the configuration file)
+if @option{-c} (@option{--configurations})
+is used.
+
+@table @option
+@item -g
+@itemx --gamma RGB|R:G:B
+
+@item -b
+@itemx --brightness RGB|R:G:B
+
+@item +b
+@itemx ++brightness Y
+
+@item -t
+@itemx --temperature TEMP
+
+@item -l
+@itemx --location LAT:LON
+
+@item -r
+@itemx --reset
+
+@item -o
+@itemx --output
+@itemx --crtc CRTC
+@end table
+
+
 
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License
-- 
cgit v1.2.3-70-g09d2