Add cg-shallow, minor fixes, and bump year1.3

Signed-off-by: Mattias Andrée <maandree@kth.se>

10 files changed, 148 insertions, 18 deletions

diff --git a/man/cg-brilliance.1 b/man/cg-brilliance.1
index 187bff2..a79583e 100644
--- a/man/cg-brilliance.1
+++ b/man/cg-brilliance.1
@@ -75,8 +75,8 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-brilliance 's
 default priority is 2305843009213693952.
 
diff --git a/man/cg-darkroom.1 b/man/cg-darkroom.1
index 2b0802e..106f62f 100644
--- a/man/cg-darkroom.1
+++ b/man/cg-darkroom.1
@@ -68,8 +68,8 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-darkroom 's
 default priority is 6917529027641081856.
 
diff --git a/man/cg-gamma.1 b/man/cg-gamma.1
index 0c9d8e7..47681f7 100644
--- a/man/cg-gamma.1
+++ b/man/cg-gamma.1
@@ -93,8 +93,8 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-gamma 's
 default priority is 0.
 
diff --git a/man/cg-icc.1 b/man/cg-icc.1
index c9ee179..8de9b82 100644
--- a/man/cg-icc.1
+++ b/man/cg-icc.1
@@ -78,8 +78,8 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-icc 's
 default priority is 0.
 
diff --git a/man/cg-limits.1 b/man/cg-limits.1
index c21ae32..363190d 100644
--- a/man/cg-limits.1
+++ b/man/cg-limits.1
@@ -108,10 +108,10 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-limits 's
-default priority is -4611686018427387904.
+default priority is \-4611686018427387904.
 
 If
 .I priority
diff --git a/man/cg-linear.1 b/man/cg-linear.1
index f101eab..cb19307 100644
--- a/man/cg-linear.1
+++ b/man/cg-linear.1
@@ -85,7 +85,7 @@ lower priority. This means that normally you want the
 to be higher than
 .IR stop-priority .
 The value must be a signed 64-bit integer (between
--9223372036854775807 and 9223372036854775808).
+\-9223372036854775807 and 9223372036854775807).
 .TP
 .BR \-R " "\fIrule-base\fP
 Set the rule base of of the filters to
diff --git a/man/cg-negative.1 b/man/cg-negative.1
index b11ecb9..098cc1b 100644
--- a/man/cg-negative.1
+++ b/man/cg-negative.1
@@ -72,8 +72,8 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-negative 's
 default priority is 4611686018427387904.
 
diff --git a/man/cg-rainbow.1 b/man/cg-rainbow.1
index 761d436..cd397f8 100644
--- a/man/cg-rainbow.1
+++ b/man/cg-rainbow.1
@@ -77,8 +77,8 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-rainbow 's
 default priority is 1152921504606846976.
 
diff --git a/man/cg-shallow.1 b/man/cg-shallow.1
new file mode 100644
index 0000000..8b80263
--- /dev/null
+++ b/man/cg-shallow.1
@@ -0,0 +1,130 @@
+.TH CG-SHALLOW 1 CG-TOOLS
+.SH NAME
+cg-shallow - Emulate low colour resolution on the monitors
+.SH SYNOPSIS
+.B cg-shallow
+.RB [ \-M
+.IR method ]
+.RB [ \-S
+.IR site ]
+.RB [ \-c
+.IR crtc "]... ["\fB\-R\fP
+.IR rule ]
+.RB ( \-x
+|
+.RB [ \-p
+.IR priority ]
+.RB [ \-d ]
+.RI [ all
+|
+.I red
+.I green
+.IR blue ])
+.SH DESCRIPTION
+.B cg-shallow
+degrades the colour resolution on the monitors, to
+.I all
+values on each channel, or to
+.IR red ,
+.IR green ,
+and
+.I blue
+to the red, green, and blue channels independently, respectively.
+A value of 0 means the resolution will not be changes. The values
+are encodingly equidistantly distributed with black and full colour
+remaining as is, unless the value 1 is specified, in which case
+it undefined which brightness the channel will be fixed at.
+.PP
+If neither
+.I all
+or
+.IR red ,
+.IR green ,
+and
+.I blue
+are specified, the value 2 for all channels is selected by default.
+.SH OPTIONS
+.TP
+.BR \-c " "\fIcrtc\fP
+Apply the filter to the CRTC with the monitor whose EDID is
+.IR crtc .
+By default, the filter is applied to all monitors.
+
+If
+.I crtc
+is
+.RB ' ? ',
+all available CRTC's are listed.
+.TP
+.B \-d
+Keep the process alive and remove the filter on death.
+.TP
+.BR \-M " "\fImethod\fP
+Adjustment method name or number. Recognised names include:
+.TS
+tab(:);
+l l.
+\fBdummy\fP:Dummy method
+\fBrandr\fP:X RAndR
+\fBvidmode\fP:X VidMode
+\fBdrm\fP:Linux DRM
+\fBgdi\fP:Windows GDI
+\fBquartz\fP:Quartz Core Graphics
+.TE
+
+The adjustment methods are supported via
+.BR libgamma (7).
+Only methods that were enabled when
+.B libgamma
+was compiled will be supported.
+
+If
+.I method
+is
+.RB ' ? ',
+all available adjustment methods are printed.
+.TP
+.BR \-p " "\fIpriority\fP
+Set the priority of the filter. Filters with higher priority
+are applied before filters with lower priority. The value
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
+.BR cg-brilliance 's
+default priority is \-6917529027641081856.
+
+If
+.I priority
+is
+.RB ' ? ',
+the utility's default priority is printed.
+.TP
+.BR \-R " "\fIrule\fP
+Set the rule of of the filter to
+.IR rule .
+This is the last part of the filter's identifier (class).
+The default rule is
+.BR standard .
+
+If
+.I rule
+is
+.RB ' ? '
+the utility's default rule is printed. If
+.I rule
+is
+.RB ' ?? '
+the utility's default class is printed.
+.TP
+.BR \-S " "\fIsite\fP
+Select the site to which to connect. For example
+.RB ' :0 ',
+for local display 0 when using
+.BR X .
+.TP
+.B \-x
+Remove the currently applied filter.
+.SH "SEE ALSO"
+.BR cg-tools (7)
+.SH BUGS
+Please report bugs to https://github.com/maandree/cg-tools/issues
+or to maandree@kth.se
diff --git a/man/cg-sleepmode.1 b/man/cg-sleepmode.1
index f5bc0ca..c750ea0 100644
--- a/man/cg-sleepmode.1
+++ b/man/cg-sleepmode.1
@@ -96,8 +96,8 @@ all available adjustment methods are printed.
 .BR \-p " "\fIpriority\fP
 Set the priority of the filter. Filters with higher priority
 are applied before filters with lower priority. The value
-must be a signed 64-bit integer (between -9223372036854775807
-and 9223372036854775808).
+must be a signed 64-bit integer (between \-9223372036854775807
+and 9223372036854775807).
 .BR cg-sleepmode 's
 default priority is 1729382256910270464.