From 790c70c8258cfe2f4458be1a83df83b9af5296d0 Mon Sep 17 00:00:00 2001
From: Mateusz Piotrowski <0mp@FreeBSD.org>
Date: Tue, 27 Oct 2020 09:41:01 +0000
Subject: [PATCH] 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)
---
 usr.bin/backlight/backlight.8 | 29 +++++++++++++----------------
 1 file changed, 13 insertions(+), 16 deletions(-)

diff --git a/usr.bin/backlight/backlight.8 b/usr.bin/backlight/backlight.8
index e734da59a567..8c3b634e152b 100644
--- a/usr.bin/backlight/backlight.8
+++ b/usr.bin/backlight/backlight.8
@@ -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