BSD 4_3_Net_2 release

[unix-history] / usr / src / usr.bin / finger / finger.1

diff --git a/usr/src/usr.bin/finger/finger.1 b/usr/src/usr.bin/finger/finger.1
index 86b4a3e..05760b5 100644 (file)
--- a/usr/src/usr.bin/finger/finger.1
+++ b/usr/src/usr.bin/finger/finger.1
@@ -1,11 +1,37 @@
 .\" Copyright (c) 1989, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Copyright (c) 1989, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"

-.\" %sccs.include.redist.man%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"     @(#)finger.1   6.11 (Berkeley) %G%
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.Dd 
+.\"    @(#)finger.1    6.14 (Berkeley) 7/27/91
+.\"
+.Dd July 27, 1991

 .Dt FINGER 1
 .Os BSD 4
 .Sh NAME
 .Dt FINGER 1
 .Os BSD 4
 .Sh NAME


@@ -14,20 +40,16 @@
 .Sh SYNOPSIS
 .Nm finger
 .Op Fl lmsp
 .Sh SYNOPSIS
 .Nm finger
 .Op Fl lmsp

-.Ob
-.Ar user
-.Op \&@host
-\&...
-.Oe
+.Op Ar user ...
+.Op Ar user@host ...

 .Sh DESCRIPTION
 The
 .Nm finger
 .Sh DESCRIPTION
 The
 .Nm finger

-command has two basic output formats providing essentially the same
-information.
+displays information about the system users.

 .Pp
 Options are:
 .Pp
 Options are:

-.Tw Ds
-.Tp Fl s
+.Bl -tag -width flag
+.It Fl s

 .Nm Finger
 displays the user's login name, real name, terminal name and write
 status (as a ``*'' after the terminal name if write permission is
 .Nm Finger
 displays the user's login name, real name, terminal name and write
 status (as a ``*'' after the terminal name if write permission is


@@ -43,12 +65,13 @@ than the hours and minutes.
 Unknown devices as well as nonexistent idle and login times are
 displayed as single asterisks.
 .Pp
 Unknown devices as well as nonexistent idle and login times are
 displayed as single asterisks.
 .Pp

-.Tp Fl l
+.It Fl l

 Produces a multi-line format displaying all of the information
 described for the
 .Fl s
 option as well as the user's home directory, home phone number, login
 shell, and the contents of the files
 Produces a multi-line format displaying all of the information
 described for the
 .Fl s
 option as well as the user's home directory, home phone number, login
 shell, and the contents of the files

+.Dq Pa .forward ,

 .Dq Pa .plan
 and
 .Dq Pa .project
 .Dq Pa .plan
 and
 .Dq Pa .project


@@ -70,21 +93,19 @@ One entry per user is displayed with the
 option; if a user is logged on multiple times, terminal information
 is repeated once per login.
 .Pp
 option; if a user is logged on multiple times, terminal information
 is repeated once per login.
 .Pp

-.Tp Fl p
+.It Fl p

 Prevents
 the
 .Fl l
 option of
 .Nm finger
 from displaying the contents of the
 Prevents
 the
 .Fl l
 option of
 .Nm finger
 from displaying the contents of the

+.Dq Pa .forward ,

 .Dq Pa .plan
 and
 .Dq Pa .project
 files.
 .Dq Pa .plan
 and
 .Dq Pa .project
 files.

-.Pp
-Note that some fields may be missing, in either format, if information
-is not available for them.
-.Tp Fl m
+.It Fl m

 Prevent matching of
 .Ar user
 names.
 Prevent matching of
 .Ar user
 names.


@@ -96,7 +117,7 @@ option is supplied.
 All name matching performed by
 .Nm finger
 is case insensitive.
 All name matching performed by
 .Nm finger
 is case insensitive.

-.Tp
+.El

 .Pp
 If no options are specified,
 .Nm finger
 .Pp
 If no options are specified,
 .Nm finger


@@ -105,6 +126,8 @@ defaults to the
 style output if operands are provided, otherwise to the
 .Fl s
 style.
 style output if operands are provided, otherwise to the
 .Fl s
 style.

+Note that some fields may be missing, in either format, if information
+is not available for them.

 .Pp
 If no arguments are specified,
 .Nm finger
 .Pp
 If no arguments are specified,
 .Nm finger


@@ -131,7 +154,8 @@ option is the only option that may be passed to a remote machine.
 .Xr chpass 1 ,
 .Xr w 1 ,
 .Xr who 1 ,
 .Xr chpass 1 ,
 .Xr w 1 ,
 .Xr who 1 ,

-.Xr getpwent 3

 .Sh HISTORY
 .Sh HISTORY

-.Nm Finger
-appeared in 3 BSD.
+The
+.Nm finger
+command appeared in
+.Bx 3.0 .