Bug 199637 - top(1) lack of -m option for 'm' mode and top(1) man page lacks columns description for 'm' mode
Summary: top(1) lack of -m option for 'm' mode and top(1) man page lacks columns descr...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Eitan Adler
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-04-23 08:03 UTC by Slawomir Wojciech Wojtczak
Modified: 2018-05-21 00:21 UTC (History)
3 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Slawomir Wojciech Wojtczak 2015-04-23 08:03:14 UTC 
The top(1) man page does not describe VCSW, IVCSW, READ, WRITE, FAULT and PERCENT columns (press 'm' in launched top).

The top(1) does not come with and command option to launch it in 'm' mode (for example -m option).

Regards,
vermaden
Comment 1 Slawomir Wojciech Wojtczak 2015-04-23 08:39:08 UTC 
Dirty workaround (no live display):

# echo 'm' | top
Comment 2 Slawomir Wojciech Wojtczak 2015-04-23 09:02:10 UTC 
Ok, my fault, top -m io does the thing, that leaves the problem to man page.
Comment 3 Christian Sturm 2017-03-06 10:59:18 UTC 
For the man page. The descriptions can be found in getrusage(2).

That's where top (1) takes the information from. It should at least
be referenced in the SEE ALSO section, but better described in the
THE DISPLAY section as well.

If I have time next weekend I can take a look at this, but I can't
promise. Would be great if this could be done who maybe has more
insight or time.
Comment 4 commit-hook freebsd_committer freebsd_triage 2018-05-21 00:21:22 UTC 
A commit references this bug:

Author: eadler
Date: Mon May 21 00:20:32 UTC 2018
New revision: 333948
URL: https://svnweb.freebsd.org/changeset/base/333948

Log:
  top(1): add getrusage to SEE also

  This documents the various columns that top might support.

  PR:		199637
  Submitted by:	vermaden@interia.pl

Changes:
  head/usr.bin/top/top.1
Comment 5 Eitan Adler freebsd_committer freebsd_triage 2018-05-21 00:21:38 UTC 
I've added a ref to getruage to see also. Replicating information is just going to lead  to at least one of the manual pages becoming stale.