summaryrefslogtreecommitdiff
path: root/sbin/route
diff options
context:
space:
mode:
authorKlemens Nanni <kn@cvs.openbsd.org>2022-12-22 19:53:25 +0000
committerKlemens Nanni <kn@cvs.openbsd.org>2022-12-22 19:53:25 +0000
commitdcd007097b9192d37a4b39e41094f0b07bfbe237 (patch)
tree5d14384480414cca7c4af172ac9a9dec1b03fdb2 /sbin/route
parent7cffd29be8ddc926f78306a722ae0466ca092588 (diff)
Denote multiple arguments with 'arg ...' not 'args'
A few programs used the plural in their synopsis which doesn't read as clear as the obvious triple-dot notation. mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent use of 'arg ...' matches that behaviour. Cleanup a few markups of the same argument so the text keeps reading naturally; omit unhelpful parts like 'if optional arguments are given, they are passed along' for tools like time(1) and timeout(1) that obviously execute commands with whatever arguments where given -- just like doas(1) which doesn't mention arguments in its DESCRIPTION in the first place. For expr(1) the difference between 'expressions' and 'expression ...' is crucial, as arguments must be passed as individual words. Feedback millert jmc schwarze deraadt OK jmc
Diffstat (limited to 'sbin/route')
-rw-r--r--sbin/route/route.818
-rw-r--r--sbin/route/route.c6
2 files changed, 12 insertions, 12 deletions
diff --git a/sbin/route/route.8 b/sbin/route/route.8
index 01116417f17..b0c000474e9 100644
--- a/sbin/route/route.8
+++ b/sbin/route/route.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: route.8,v 1.108 2022/12/22 07:46:19 jmc Exp $
+.\" $OpenBSD: route.8,v 1.109 2022/12/22 19:53:22 kn Exp $
.\" $NetBSD: route.8,v 1.6 1995/03/18 15:00:13 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
@@ -42,8 +42,8 @@
.Op Fl T Ar rtable
.Ar command
.Oo
-.Op Ar modifiers
-.Ar args
+.Op Ar modifier ...
+.Ar arg ...
.Oc
.Sh DESCRIPTION
.Nm
@@ -112,7 +112,7 @@ option.
.Op Fl T Ar rtable
.Tg
.Cm flush
-.Op Ar modifiers
+.Op Ar modifier ...
.Xc
Delete all gateway entries from the routing table.
When the address family is specified by any one of the
@@ -132,7 +132,7 @@ modifiers.
.Op Fl T Ar rtable
.Tg
.Cm get
-.Op Ar modifiers
+.Op Ar modifier ...
.Ar address
.Xc
Extract a routing entry from the kernel.
@@ -147,7 +147,7 @@ same address family as the destination are shown.
.Op Fl T Ar rtable
.Tg
.Cm monitor
-.Op Ar modifiers
+.Op Ar modifier ...
.Xc
Continuously report any changes to the routing information base,
routing lookup misses, or suspected network partitionings.
@@ -303,7 +303,7 @@ have the syntax:
.Op Fl T Ar rtable
.Tg
.Cm add
-.Op Ar modifiers
+.Op Ar modifier ...
.Ar destination gateway
.Xc
.It Xo
@@ -312,7 +312,7 @@ have the syntax:
.Op Fl T Ar rtable
.Tg
.Cm change
-.Op Ar modifiers
+.Op Ar modifier ...
.Ar destination gateway
.Xc
.It Xo
@@ -322,7 +322,7 @@ have the syntax:
.Tg delete
.Tg
.Cm del Ns Op Cm ete
-.Op Ar modifiers
+.Op Ar modifier ...
.Ar destination gateway
.Xc
.El
diff --git a/sbin/route/route.c b/sbin/route/route.c
index fc58858b2a1..05645a6c9e9 100644
--- a/sbin/route/route.c
+++ b/sbin/route/route.c
@@ -1,4 +1,4 @@
-/* $OpenBSD: route.c,v 1.260 2021/11/10 20:24:22 bket Exp $ */
+/* $OpenBSD: route.c,v 1.261 2022/12/22 19:53:22 kn Exp $ */
/* $NetBSD: route.c,v 1.16 1996/04/15 18:27:05 cgd Exp $ */
/*
@@ -135,9 +135,9 @@ usage(char *cp)
warnx("botched keyword: %s", cp);
fprintf(stderr,
#ifndef SMALL
- "usage: %s [-dnqtv] [-T rtable] command [[modifiers] args]\n",
+ "usage: %s [-dnqtv] [-T rtable] command [[modifier ...] arg ...]\n",
#else
- "usage: %s [-dnqtv] command [[modifiers] args]\n",
+ "usage: %s [-dnqtv] command [[modifier ...] arg ...]\n",
#endif
__progname);
exit(1);