From 4590bd10292b556cc4dd47187c60bc6a5f0f3e4f Mon Sep 17 00:00:00 2001
From: anton <anton@openbsd.org>
Date: Sat, 25 Aug 2018 15:18:34 +0000
Subject: [PATCH] markup flag arguments; ok jmc@ schwarze@

---
 bin/chmod/chflags.1 | 42 ++++++++++++++++++++++++++----------------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/bin/chmod/chflags.1 b/bin/chmod/chflags.1
index 2cdba9ab6ec..7f14b9510bf 100644
--- a/bin/chmod/chflags.1
+++ b/bin/chmod/chflags.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: chflags.1,v 1.17 2018/08/05 19:12:56 schwarze Exp $
+.\"	$OpenBSD: chflags.1,v 1.18 2018/08/25 15:18:34 anton Exp $
 .\"	$NetBSD: chflags.1,v 1.4 1995/08/31 22:50:22 jtc Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993, 1994
@@ -33,7 +33,7 @@
 .\"
 .\"	@(#)chflags.1	8.4 (Berkeley) 5/2/95
 .\"
-.Dd $Mdocdate: August 5 2018 $
+.Dd $Mdocdate: August 25 2018 $
 .Dt CHFLAGS 1
 .Os
 .Sh NAME
@@ -100,22 +100,29 @@ in the file hierarchy below it.
 .Pp
 Flags are a comma separated list of keywords.
 The following keywords are currently defined:
-.Bd -literal -offset indent
-arch	set the archived flag (superuser only)
-nodump	set the nodump flag (owner or superuser only)
-sappnd	set the system append-only flag (superuser only)
-schg	set the system immutable flag (superuser only)
-uappnd	set the user append-only flag (owner or superuser only)
-uchg	set the user immutable flag (owner or superuser only)
-.Ed
+.Pp
+.Bl -tag -width "nodump" -compact -offset indent
+.It Cm arch
+set the archived flag (superuser only)
+.It Cm nodump
+set the nodump flag (owner or superuser only)
+.It Cm sappnd
+set the system append-only flag (superuser only)
+.It Cm schg
+set the system immutable flag (superuser only)
+.It Cm uappnd
+set the user append-only flag (owner or superuser only)
+.It Cm uchg
+set the user immutable flag (owner or superuser only)
+.El
 .Pp
 The
-.Dq arch
+.Cm arch
 flag is for compatibility only,
 and currently has no effect.
 .Pp
 A file with the
-.Dq nodump
+.Cm nodump
 flag set will by default only be backed up by
 .Xr dump 8
 during full backups.
@@ -130,9 +137,9 @@ An append-only file is immutable except that data may be appended to it.
 .Pp
 The
 superuser-settable
-.Dq sappnd
+.Cm sappnd
 and
-.Dq schg
+.Cm schg
 flags can be set at any time, but may only be cleared when the system is
 running at security level 0 or \-1
 (insecure or permanently insecure mode, respectively).
@@ -141,11 +148,14 @@ see
 .Xr securelevel 7 .
 .Pp
 Putting the letters
-.Dq no
+.Cm no
 before a flag name causes the flag to be turned off.
 For example:
 .Pp
-.Dl nouchg	the immutable bit should be cleared
+.Bl -tag -width "nouchg" -compact -offset indent
+.It Cm nouchg
+the immutable bit should be cleared
+.El
 .Pp
 The
 .Fl H ,
-- 
2.20.1