NetBSD Problem Report #57305

From www@netbsd.org  Tue Mar 28 09:38:57 2023
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 4C8DC1A9239
	for <gnats-bugs@gnats.NetBSD.org>; Tue, 28 Mar 2023 09:38:57 +0000 (UTC)
Message-Id: <20230328093855.F057E1A923C@mollari.NetBSD.org>
Date: Tue, 28 Mar 2023 09:38:55 +0000 (UTC)
From: nan@chinadtrace.org
Reply-To: nan@chinadtrace.org
To: gnats-bugs@NetBSD.org
Subject: Maybe a typo in sysstat(1) man page
X-Send-Pr-Version: www-1.0

>Number:         57305
>Category:       misc
>Synopsis:       Maybe a typo in sysstat(1) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Mar 28 09:40:00 +0000 2023
>Closed-Date:    Wed Mar 29 19:55:40 +0000 2023
>Last-Modified:  Wed Mar 29 19:55:40 +0000 2023
>Originator:     Nan Xiao
>Release:        
>Organization:
>Environment:
>Description:
Hi NetBSD community,

In the third graph of Description, https://man.netbsd.org/amd64/sysstat.1:

> network ``mbuf'' utilization, network 'ifstat' traffic, and network connections ...

It seems should be:

> network ``mbuf'' utilization, network ``ifstat'' traffic, ...

Please help to check, thanks!

Best Regards
Nan Xiao
>How-To-Repeat:

>Fix:

>Release-Note:

>Audit-Trail:
From: Valery Ushakov <uwe@stderr.spb.ru>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/57305: Maybe a typo in sysstat(1) man page
Date: Wed, 29 Mar 2023 21:31:15 +0300

 On Tue, Mar 28, 2023 at 09:40:00 +0000, nan@chinadtrace.org wrote:


 > It seems should be:
 > 
 > > network ``mbuf'' utilization, network ``ifstat'' traffic, ...

 That "ifstat" reference seems totally meanigless/useless to me.  May
 be it means something over on the freebsd side of things where the
 code was taken from.  I'd just change that to "network interface
 traffic" which what it really is.

 That man page shows its age and needs quite a face lift anyway.

 -uwe

From: Robert Elz <kre@munnari.OZ.AU>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/57305: Maybe a typo in sysstat(1) man page
Date: Thu, 30 Mar 2023 02:30:04 +0700

     Date:        Wed, 29 Mar 2023 18:35:01 +0000 (UTC)
     From:        Valery Ushakov <uwe@stderr.spb.ru>
     Message-ID:  <20230329183501.EF09D1A923C@mollari.NetBSD.org>

   |  That "ifstat" reference seems totally meanigless/useless to me.

 The quoted words refer to the systat commands that display different
 info sets.   The network stuff is (I think) called out specifically as
 there are several different network related displays available.

   |  That man page shows its age and needs quite a face lift anyway.

 That's probably true.

 kre


From: "Robert Elz" <kre@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/57305 CVS commit: src/usr.bin/systat
Date: Wed, 29 Mar 2023 19:40:18 +0000

 Module Name:	src
 Committed By:	kre
 Date:		Wed Mar 29 19:40:18 UTC 2023

 Modified Files:
 	src/usr.bin/systat: systat.1

 Log Message:
 PR misc/57305 from Nan Xiao

 Be consistent with method (and style) when referring to the mbufs and
 ifstat sub-commands when describing what is available (and correct
 "mbuf" to be "mbufs" which is what the internal command really is).

 That is don't just "double quote" one and 'single quote' the other.


 To generate a diff of this commit:
 cvs rdiff -u -r1.52 -r1.53 src/usr.bin/systat/systat.1

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: kre@NetBSD.org
State-Changed-When: Wed, 29 Mar 2023 19:55:40 +0000
State-Changed-Why:
Man page updated.  Thanks for the report.


>Unformatted:

Home	PR Database Search