Author: 0mp (doc,ports committer)
Date: Tue Oct 27 09:41:01 2020
New Revision: 367073
URL: https://svnweb.freebsd.org/changeset/base/367073
Log:
Clean up backlight.8
- Sort flags
- Stylize incr|+ and decr|- properly
- Add a missing period at the end of the description
- Use the standard layout for the EXAMPLES section (remove the list macro
and add indentation to the code block)
Modified:
head/usr.bin/backlight/backlight.8
Modified: head/usr.bin/backlight/backlight.8
==============================================================================
--- head/usr.bin/backlight/backlight.8 Tue Oct 27 09:32:06 2020
(r367072)
+++ head/usr.bin/backlight/backlight.8 Tue Oct 27 09:41:01 2020
(r367073)
@@ -22,7 +22,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd October 06, 2020
+.Dd October 27, 2020
.Dt BACKLIGHT 8
.Os
.Sh NAME
@@ -31,21 +31,21 @@
.Sh SYNOPSIS
.Nm
.Op Fl f Ar device
-.Op Fl q
.Op Fl i
+.Op Fl q
.Op Ar value
.Nm
.Op Fl f Ar device
-incr | +
+.Cm incr Ns | Ns Cm +
.Op Ar value
.Nm
.Op Fl f Ar device
-decr | -
+.Cm decr Ns | Ns Cm -
.Op Ar value
.Sh DESCRIPTION
The
.Nm
-utility can be used to configure brightness levels for registered backlights
+utility can be used to configure brightness levels for registered backlights.
.Pp
The options are as follows:
.Bl -tag -width "-f device"
@@ -57,30 +57,27 @@ is used.
If an unqualified name is provided,
.Pa /dev/backlight
is automatically prepended.
-.It Fl q
-When querying the brightness level only print the value.
.It Fl i
Query information about the backlight (name, type).
+.It Fl q
+When querying the brightness level only print the value.
.It Ar value
Set the brightness level to this value, must be between 0 and 100.
-A trailing '%' is valid.
-.It Ar incr | +
-.Op Ar value
+A trailing
+.Dq %
+is valid.
+.It Cm incr Ns | Ns Cm + Op Ar value
Decrement the backlight level.
If no value is specified a default of 10 percent is used.
-.It Ar decr | -
-.Op Ar value
+.It Cm decr Ns | Ns Cm - Op Ar value
Increment the backlight level.
If no value is specified a default of 10 percent is used.
.El
.Sh EXAMPLES
-.Bl -bullet
-.It
Show the current brightness level
-.Bd -literal
+.Bd -literal -offset indent
backlight -f /dev/backlight/backlight0
.Ed
-.El
.Sh SEE ALSO
.Xr backlight 9
.Sh HISTORY
_______________________________________________
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
