summaryrefslogtreecommitdiffstats
path: root/term-utils/mesg.1
diff options
context:
space:
mode:
authorBenno Schulenberg2014-07-15 23:07:37 +0200
committerKarel Zak2014-07-16 12:03:25 +0200
commit6e72fa5965d121812db5d0186b06fd988bb5699c (patch)
tree49cba561b1c054e4e4e3ce69adfaf70ee91d252c /term-utils/mesg.1
parentdocs: bring several man pages closer to standard formatting (diff)
downloadkernel-qcow2-util-linux-6e72fa5965d121812db5d0186b06fd988bb5699c.tar.gz
kernel-qcow2-util-linux-6e72fa5965d121812db5d0186b06fd988bb5699c.tar.xz
kernel-qcow2-util-linux-6e72fa5965d121812db5d0186b06fd988bb5699c.zip
docs: bring a few more man pages closer to standard formatting
Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
Diffstat (limited to 'term-utils/mesg.1')
-rw-r--r--term-utils/mesg.143
1 files changed, 20 insertions, 23 deletions
diff --git a/term-utils/mesg.1 b/term-utils/mesg.1
index f7ebf4195..9bdc6d566 100644
--- a/term-utils/mesg.1
+++ b/term-utils/mesg.1
@@ -31,23 +31,18 @@
.\"
.\" @(#)mesg.1 8.1 (Berkeley) 6/6/93
.\"
-.\" Fri Mar 10 20:31:02 1995, modified for standard man macros,
-.\" faith@cs.unc.edu
-.\"
-.\"
-.\" "
-.TH MESG 1 "April 2011" "util-linux" "User Commands"
+.TH MESG 1 "July 2014" "util-linux" "User Commands"
.SH NAME
-mesg \- display (do not display) messages from other users
+mesg \- display (or do not display) messages from other users
.SH SYNOPSIS
.B mesg
-.RB [options]
+[option]
.RB [ n | y ]
.SH DESCRIPTION
The
.B mesg
-utility is invoked by a users to control write access others have to the
-terminal device associated with the standard error output. If write access
+utility is invoked by a user to control write access others have to the
+terminal device associated with standard error output. If write access
is allowed, then programs such as
.BR talk (1)
and
@@ -63,37 +58,39 @@ should be executed in your login scripts.
.SH ARGUMENTS
.TP
.B n
-Disallows messages.
+Disallow messages.
.TP
.B y
-Permits messages to be displayed.
+Allow messages to be displayed.
+.PP
+If no arguments are given,
+.B mesg
+shows the current message status on standard error output.
.SH OPTIONS
.TP
-.B \-v, \-\-verbose
+.BR \-v , " \-\-verbose"
Explain what is being done.
.TP
-.B \-V, \-\-verbose
+.BR \-V , " \-\-version"
Display version information and exit.
.TP
-.B \-h, \-\-help
+.BR \-h , " \-\-help"
Display help text and exit.
-.PP
-If no arguments are given,
-.B mesg
-displays the present message status to the standard error output.
-.PP
+.SH EXIT STATUS
The
.B mesg
utility exits with one of the following values:
+.RS 4
.TP
-.I "\ 0"
+.B "\ 0"
Messages are allowed.
.TP
-.I "\ 1"
+.B "\ 1"
Messages are not allowed.
.TP
-.I ">1"
+.B ">1"
An error has occurred.
+.RE
.SH FILES
.I /dev/[pt]ty[pq]?
.SH "SEE ALSO"