Date: 09 Dec 2001 20:52:51 -0800 From: "Gary W. Swearingen" <swear@blarg.net> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/32662: arp(8) uses "this host" with two different meanings. Message-ID: <ffvgfffzh8.gff@localhost.localdomain>
index | next in thread | raw e-mail
>Number: 32662 >Category: docs >Synopsis: arp(8) uses "this host" with two different meanings. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Dec 09 21:00:01 PST 2001 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 4.4-RELEASE i386 >Organization: none >Environment: n/a ================ >Description: 1) The -S and -s option descriptions use "this host" to mean "the host named" and "the host running arp". Could be clearer. 2) Lines before option descriptions are inconsistent in their use of option arguments. Better to just omit and require look at synopsis section in this small man page. 3) The -f option description doesn't say that the file may not have comments. ================ >How-To-Repeat: n/a ================ >Fix: patch -d "unknown uncompressed man directory" < this-PR --- /tmp/arp..orig.8 Sun Dec 9 20:02:06 2001 +++ /tmp/arp.8 Sun Dec 9 20:41:24 2001 @@ -81,7 +81,7 @@ .Tn ARP entries. .It Fl d -A super-user may delete an entry for the host called +A super-user may delete an entry for the host named .Ar hostname with the .Fl d @@ -96,10 +96,10 @@ Show network addresses as numbers (normally .Nm attempts to display addresses symbolically). -.It Fl s Ar hostname ether_addr +.It Fl s Create an .Tn ARP -entry for the host called +entry for the host named .Ar hostname with the Ethernet address .Ar ether_addr . @@ -122,15 +122,19 @@ .Ar ether_addr can be given as .Cm auto -in which case the interfaces on this host will be examined, +in which case the interfaces of the computer running +.Nm +will be examined, and if one of them is found to occupy the same subnet, its Ethernet address will be used. -.It Fl S Ar hostname ether_addr +.It Fl S Is just like .Fl s except any existing .Tn ARP -entry for this host will be deleted first. +entry for the host named +.Ar hostname +will be deleted first. .It Fl f Causes the file .Ar filename @@ -146,6 +150,7 @@ .Ed .Pp with argument meanings as given above. +There is no support for comments in the file. .El .Sh SEE ALSO .Xr inet 3 , >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the messagehelp
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?ffvgfffzh8.gff>