From owner-svn-src-head@freebsd.org Tue Oct 27 09:41:02 2020 Return-Path: Delivered-To: svn-src-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 9037F445AE0; Tue, 27 Oct 2020 09:41:02 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4CL6CL3JDTz4ZGB; Tue, 27 Oct 2020 09:41:02 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 5383096A7; Tue, 27 Oct 2020 09:41:02 +0000 (UTC) (envelope-from 0mp@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 09R9f2xt013941; Tue, 27 Oct 2020 09:41:02 GMT (envelope-from 0mp@FreeBSD.org) Received: (from 0mp@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 09R9f2xd013940; Tue, 27 Oct 2020 09:41:02 GMT (envelope-from 0mp@FreeBSD.org) Message-Id: <202010270941.09R9f2xd013940@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: 0mp set sender to 0mp@FreeBSD.org using -f From: Mateusz Piotrowski <0mp@FreeBSD.org> Date: Tue, 27 Oct 2020 09:41:02 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r367073 - head/usr.bin/backlight X-SVN-Group: head X-SVN-Commit-Author: 0mp X-SVN-Commit-Paths: head/usr.bin/backlight X-SVN-Commit-Revision: 367073 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 27 Oct 2020 09:41:02 -0000 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