documentation: rewrite for shared in free

Minor tweaks in the free manual page
* Removed author section. It's wrong and strongly discouraged
  by the man page standards.
* Moved note about shared not in old kernels into bugs sections
as this is not relevant for most people and declutters the top
sections.

References:
 https://bugs.debian.org/755233

Signed-off-by: Craig Small <csmall@enc.com.au>
This commit is contained in:
Craig Small 2016-07-03 10:36:58 +10:00
parent 365cb37029
commit d936f62eec

18
free.1
View File

@ -2,7 +2,7 @@
.\" This page Copyright (C) 1993 Matt Welsh, mdw@sunsite.unc.edu. .\" This page Copyright (C) 1993 Matt Welsh, mdw@sunsite.unc.edu.
.\" Long options where added at April 15th, 2011. .\" Long options where added at April 15th, 2011.
.\" Freely distributable under the terms of the GPL .\" Freely distributable under the terms of the GPL
.TH FREE 1 "Apr 2015" "procps-ng" "User Commands" .TH FREE 1 "Jul 2016" "procps-ng" "User Commands"
.SH NAME .SH NAME
free \- Display amount of free and used memory in the system free \- Display amount of free and used memory in the system
.SH SYNOPSIS .SH SYNOPSIS
@ -25,8 +25,7 @@ Used memory (calculated as \fBtotal\fR - \fBfree\fR - \fBbuffers\fR - \fBcache\f
Unused memory (MemFree and SwapFree in /proc/meminfo) Unused memory (MemFree and SwapFree in /proc/meminfo)
.TP .TP
\fBshared\fR \fBshared\fR
Memory used (mostly) by tmpfs (Shmem in /proc/meminfo, available on Memory used (mostly) by tmpfs (Shmem in /proc/meminfo)
kernels 2.6.32, displayed as zero if not available)
.TP .TP
\fBbuffers\fR \fBbuffers\fR
Memory used by kernel buffers (Buffers in /proc/meminfo) Memory used by kernel buffers (Buffers in /proc/meminfo)
@ -137,14 +136,15 @@ Display version information.
/proc/meminfo /proc/meminfo
memory information memory information
.PD .PD
.SH BUGS
The value for the \fBshared\fR column is not available from kernels before
2.6.32 and is displayed as zero.
.TP
Please send bug reports to
.UR procps@freelists.org
.UE
.SH "SEE ALSO" .SH "SEE ALSO"
.BR ps (1), .BR ps (1),
.BR slabtop (1), .BR slabtop (1),
.BR top "(1), .BR top "(1),
.BR vmstat (8). .BR vmstat (8).
.SH AUTHORS
Written by Brian Edmonds.
.SH "REPORTING BUGS"
Please send bug reports to
.UR procps@freelists.org
.UE