doc -M ?, -c ?, -R ?, and -R ??

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

10 files changed, 248 insertions, 0 deletions

diff --git a/man/cg-brilliance.1 b/man/cg-brilliance.1
index d61f642..a78f8ab 100644
--- a/man/cg-brilliance.1
+++ b/man/cg-brilliance.1
@@ -37,6 +37,12 @@ A value of 0 means complete darkness, and 1 means normal brilliance.
 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.
@@ -58,6 +64,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -66,6 +78,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-brilliance 's
 default priority is 2305843009213693952.
+
+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
@@ -73,6 +91,16 @@ Set the rule of of the filter to
 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
diff --git a/man/cg-darkroom.1 b/man/cg-darkroom.1
index 3125489..ee3d636 100644
--- a/man/cg-darkroom.1
+++ b/man/cg-darkroom.1
@@ -30,6 +30,12 @@ and 1 means normal brilliance.
 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.
@@ -51,6 +57,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -59,6 +71,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-darkroom '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
@@ -66,6 +84,16 @@ Set the rule of of the filter to
 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
diff --git a/man/cg-gamma.1 b/man/cg-gamma.1
index e80e47d..467b58b 100644
--- a/man/cg-gamma.1
+++ b/man/cg-gamma.1
@@ -53,6 +53,12 @@ Read the gamma values from the selected file.
 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.
@@ -74,6 +80,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -82,6 +94,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-gamma 's
 default priority is 0.
+
+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
@@ -89,6 +107,16 @@ Set the rule of of the filter to
 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
diff --git a/man/cg-icc.1 b/man/cg-icc.1
index 1e30e75..7473634 100644
--- a/man/cg-icc.1
+++ b/man/cg-icc.1
@@ -38,6 +38,12 @@ ICC file for that monitor.
 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.
@@ -59,6 +65,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -67,6 +79,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-icc 's
 default priority is 0.
+
+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
@@ -74,6 +92,16 @@ Set the rule of of the filter to
 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
diff --git a/man/cg-limits.1 b/man/cg-limits.1
index 5db434c..dedaf69 100644
--- a/man/cg-limits.1
+++ b/man/cg-limits.1
@@ -68,6 +68,12 @@ Read the contrast values from the selected file.
 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.
@@ -89,6 +95,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -97,6 +109,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-limits 's
 default priority is -4611686018427387904.
+
+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
@@ -104,6 +122,16 @@ Set the rule of of the filter to
 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
diff --git a/man/cg-negative.1 b/man/cg-negative.1
index 3777b98..4fdc010 100644
--- a/man/cg-negative.1
+++ b/man/cg-negative.1
@@ -34,6 +34,12 @@ Do not invert the blue channel.
 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.
@@ -55,6 +61,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -63,6 +75,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-negative 's
 default priority is 4611686018427387904.
+
+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
@@ -70,6 +88,16 @@ Set the rule of of the filter to
 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
diff --git a/man/cg-query.1 b/man/cg-query.1
index 0ebbbfc..0ae2bb9 100644
--- a/man/cg-query.1
+++ b/man/cg-query.1
@@ -31,6 +31,12 @@ Do not list filter with lower priority than
 .BR \-c " "\fIcrtc\fP
 Apply the filter to the CRTC with the monitor whose EDID is
 .IR crtc .
+
+If
+.I crtc
+is
+.RB ' ? ',
+all available CRTC's are listed.
 .TP
 .BR \-M " "\fImethod\fP
 Adjustment method name or number. Recognised names include:
@@ -49,6 +55,12 @@ The adjustment methods are supported via
 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 \-S " "\fIsite\fP
 Select the site to which to connect. For example
diff --git a/man/cg-rainbow.1 b/man/cg-rainbow.1
index 437ceb9..7752619 100644
--- a/man/cg-rainbow.1
+++ b/man/cg-rainbow.1
@@ -42,6 +42,12 @@ default frequency is one third.
 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
 .BR \-M " "\fImethod\fP
 Adjustment method name or number. Recognised names include:
@@ -60,6 +66,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -68,6 +80,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-rainbow 's
 default priority is 1152921504606846976.
+
+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
@@ -75,6 +93,16 @@ Set the rule of of the filter to
 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
diff --git a/man/cg-remove.1 b/man/cg-remove.1
index 4b1ba04..9dc721c 100644
--- a/man/cg-remove.1
+++ b/man/cg-remove.1
@@ -19,6 +19,12 @@ remove the filters with the selected
 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
 .BR \-M " "\fImethod\fP
 Adjustment method name or number. Recognised names include:
@@ -37,6 +43,12 @@ The adjustment methods are supported via
 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 \-S " "\fIsite\fP
 Select the site to which to connect. For example
diff --git a/man/cg-sleepmode.1 b/man/cg-sleepmode.1
index 2a752ca..278ab48 100644
--- a/man/cg-sleepmode.1
+++ b/man/cg-sleepmode.1
@@ -61,6 +61,12 @@ is 1 second.
 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
 .BR \-M " "\fImethod\fP
 Adjustment method name or number. Recognised names include:
@@ -79,6 +85,12 @@ The adjustment methods are supported via
 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 lower priority
@@ -87,6 +99,12 @@ must be a signed 64-bit integer (between -9223372036854775807
 and 9223372036854775808).
 .BR cg-sleepmode 's
 default priority is 1729382256910270464.
+
+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
@@ -94,6 +112,16 @@ Set the rule of of the filter to
 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