From 6d4eece8f967a22a62501963acb96f6740c3a8fb Mon Sep 17 00:00:00 2001 From: Mykyta Holubakha Date: Wed, 24 Jan 2018 22:35:21 +0200 Subject: Improved manpage thanks @SirCmpwn --- brightnessctl.1 | 141 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 141 insertions(+) create mode 100644 brightnessctl.1 (limited to 'brightnessctl.1') diff --git a/brightnessctl.1 b/brightnessctl.1 new file mode 100644 index 0000000..46f59db --- /dev/null +++ b/brightnessctl.1 @@ -0,0 +1,141 @@ +.TH "BRIGHTNESSCTL" "1" "24th Jan 2018" "brightnessctl" "brightnessctl" + +.SH "NAME" +brightnessctl \- read and control device brightness + + +.SH "SYNOPSIS" + +.sp +\fIbrightnessctl\fR [options] \fI[operation]\fR [value...] + + +.SH "OPTIONS" + +.sp +\fB\-h, \-\-help\fP +.RS 4 +Print this help. +.RE + +.sp +\fB\-l, \-\-list\fP +.RS 4 +List devices with available brightness controls. +.RE + +.sp +\fB\-q, \-\-quiet\fP +.RS 4 +Suppress output. +.RE + +.sp +\fB\-p, \-\-pretend\fP +.RS 4 +Do not perform write operations. +.RE + +.sp +\fB\-m, \-\-machine\-readable\fP +.RS 4 +Produce machine\-readable output. +.RE + +.sp +\fB\-s, \-\-save\fP +.RS 4 +Save state in a temporary file. +.RE + +.sp +\fB\-r, \-\-restore\fP +.RS 4 +Restore previously\-saved state. +.RE + +.sp +\fB\-d, \-\-device\fP=\fIDEVICE\fP +.RS 4 +Specify device name (can be a wildcard). +.RE + +.sp +\fB\-c, \-\-class\fP=\fICLASS\fP +.RS 4 +Specify device class. +.RE + +.sp +\fB\-v, \-\-version\fP +.RS 4 +Print version and exit. +.RE + + +.SH "OPERATIONS" + +.sp +\fBi, info\fP +.RS 4 +Get device info. +.RE + +.sp +\fBg, get\fP +.RS 4 +Get the current brightness of the device. +.RE + +.sp +\fBm, max\fP +.RS 4 +Get the maximum brightness of the device. +.RE + +.sp +\fBs, set\fP \fIVALUE\fP +.RS 4 +Set the brightness of the device. + +.SS VALUES +.P +You may specify \fIVALUE\fR for the \fBset\fR command in absolute or relative form, and +as a value or a delta from the current value. For example: +.P +\fBbrightnessctl set 500\fR +.RS "4" +Sets brightness to 500. +.P +.RE +\fBbrightnessctl set 50%\fR +.RS "4" +Sets brightness to 50% of the maximum. +.P +.RE +\fBbrightnessctl set 50-\fR +.RS "4" +Subtracts 50 from the current brightness. +.P +.RE +\fBbrightnessctl set +10\fR +.RS "4" +Adds 10 to the current brightness. +.P +.RE +\fBbrightnessctl set 50%-\fR +.RS "4" +Subtracts 50% of the maximum from the current brightness. +.P +.RE +\fBbrightnessctl set +10%\fR +.RS "4" +Adds 10% of the maximum to the current brightness. +.P +.RE +.SH AUTHORS +.P +Maintained by Mykyta Holubakha, who is assisted by other open source +contributors. For more information about brightnessctl development, visit: +.P +https://github.com/Hummer12007/brightnessctl -- cgit v1.2.3