docs: add long options to last.1 manual page

And align the manual page with Documentation/howto-man-page.txt

Signed-off-by: Sami Kerola <kerolasa@iki.fi>

1 files changed, 102 insertions, 78 deletions

diff --git a/login-utils/last.1 b/login-utils/last.1
index 0eaec110e..eff6fe449 100644
--- a/login-utils/last.1
+++ b/login-utils/last.1
@@ -1,4 +1,3 @@
-'\" -*- coding: UTF-8 -*-
 .\" Copyright (C) 1998-2004 Miquel van Smoorenburg.
 .\"
 .\" This program is free software; you can redistribute it and/or modify
@@ -15,113 +14,138 @@
 .\" along with this program; if not, write to the Free Software
 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 .\"
-.\"{{{}}}
-.\"{{{  Title
-.TH LAST,LASTB 1 "Jul 31, 2004" "" "Linux System Administrator's Manual"
-.\"}}}
-.\"{{{  Name
+.TH "LAST,LASTB" "1" "August 2013" "util-linux" "User Commands"
 .SH NAME
 last, lastb \- show listing of last logged in users
-.\"}}}
-.\"{{{  Synopsis
 .SH SYNOPSIS
 .B last
-.RB [ \-R ]
-.RB [ \-\fInum\fP ]
-.RB "[ \-\fBn\fP \fInum\fP ]"
-.RB [ \-adFiowx ]
-.RB "[ \-\fBf\fP \fIfile\fP ]"
-.RB "[ \-\fBt\fP \fIYYYYMMDDHHMMSS\fP ]"
+.RI [ options ]
 .RI [ name... ]
 .RI [ tty... ]
 .br
 .B lastb
-.RB [ \-R ]
-.RB [ \-\fInum\fP ]
-.RB "[ \-\fBn\fP \fInum\fP ]"
-.RB "[ \-\fBf\fP \fIfile\fP ]"
-.RB [ \-adFiowx ]
+.RI [ options ]
 .RI [ name... ]
 .RI [ tty... ]
-.\"}}}
-.\"{{{  Description
 .SH DESCRIPTION
-.B Last
-searches back through the file \fB/var/log/wtmp\fP (or the file
-designated by the \fB\-f\fP flag) and displays a list of all
-users logged in (and out) since that file was created.  Names of users
-and tty's can be given, in which case \fBlast\fP will show only those entries
-matching the arguments.  Names of ttys can be abbreviated, thus \fBlast
-0\fP is the same as \fBlast tty0\fP.
+.B last
+searches back through the file
+.B /var/log/wtmp
+(or the file designated by the
+.B \-f
+option) and displays a list of all users logged in (and out) since that
+file was created.
+.I Names
+of users and
+.IR tty 's
+can be given, in which case
+.B last
+will show only those entries matching the arguments.  Names of
+.I ttys
+can be abbreviated, thus
+.B last 0
+is the same as
+.BR "last tty0" .
 .PP
-When \fBlast\fP catches a \s-2SIGINT\s0 signal (generated by the interrupt key,
-usually control-C) or a \s-2SIGQUIT\s0 signal (generated by the quit key,
-usually control-\e), \fBlast\fP will show how far it has searched through the
-file; in the case of the \s-2SIGINT\s0 signal \fBlast\fP will then terminate.
+When
+.B last
+catches a \s-2SIGINT\s0 signal (generated by the interrupt key, usually
+control-C) or a \s-2SIGQUIT\s0 signal,
+.B last
+will show how far it has searched through the file; in the case of the
+\s-2SIGINT\s0 signal
+.B last
+will then terminate.
 .PP
-The pseudo user \fBreboot\fP logs in each time the system is rebooted.
-Thus \fBlast reboot\fP will show a log of all reboots since the log file
-was created.
+The pseudo user
+.B reboot
+logs in each time the system is rebooted.  Thus
+.B last reboot
+will show a log of all reboots since the log file was created.
 .PP
-\fBLastb\fP is the same as \fBlast\fP, except that by default it shows a log
-of the file \fB/var/log/btmp\fP, which contains all the bad login attempts.
-.\"}}}
-.\"{{{  Options
+.B lastb
+is the same as
+.BR last ,
+except that by default it shows a log of the file
+.BR /var/log/btmp ,
+which contains all the bad login attempts.
 .SH OPTIONS
-.IP "\fB\-f\fP \fIfile\fP"
-Tells \fBlast\fP to use a specific file instead of \fB/var/log/wtmp\fP.
-.IP \fB\-\fP\fInum\fP
-This is a count telling \fBlast\fP how many lines to show.
-.IP "\fB\-n\fP \fInum\fP"
-The same.
-.IP "\fB\-t\fP \fIYYYYMMDDHHMMSS\fP"
-Display the state of logins as of the specified time.  This is
-useful, e.g., to determine easily who was logged in at a particular
-time -- specify that time with \fB\-t\fP and look for "still logged
-in".
-.IP "\fB\-f\fP \fIfile\fP"
-Specifies a file to search other than \fB/var/log/wtmp\fP.
-.IP \fB\-R\fP
+.TP
+\fB\-f\fR, \fB\-\-file\fR \fIfile\fR
+Tell
+.B last
+to use a specific file instead of
+.BR /var/log/wtmp .
+.TP
+\fB\-\fInumber\fR
+.TQ
+\fB\-n\fR, \fB\-\-limit\fR \fInumber\fR
+This is a count telling
+.B last
+how many lines to show.
+.TP
+\fB\-t\fR, \fB\-\-until\fR \fIYYYYMMDDHHMMSS\fR
+Display the state of logins as of the specified time.  This is useful,
+e.g., to determine easily who was logged in at a particular time --
+specify that time with
+.B \-\-until
+and look for "still logged in".
+.TP
+\fB\-F\fR, \fB\-\-fulltimes\fR
+Print full login and logout times and dates.
+.TP
+\fB\-R\fR, \fB\-\-nohostname\fR
 Suppresses the display of the hostname field.
-.IP \fB\-a\fP
-Display the hostname in the last column. Useful in combination
-with the next flag.
-.IP \fB\-d\fP
+.TP
+\fB\-a\fR, \fB\-\-hostlast\fR
+Display the hostname in the last column.  Useful in combination with the
+.B \-\-dns
+option.
+.TP
+\fB\-d\fR, \fB\-\-dns\fR
 For non-local logins, Linux stores not only the host name of the remote
-host but its IP number as well. This option translates the IP number
+host but its IP number as well.  This option translates the IP number
 back into a hostname.
-.IP \fB\-F\fP
+.TP
+\fB\-F\fR, \fB\-\-fullnames\fR
 Print full login and logout times and dates.
-.IP \fB\-i\fP
-This option is like \fB-d\fP in that it displays the IP number of the remote
-host, but it displays the IP number in numbers-and-dots notation.
-.IP \fB\-w\fP
+.TP
+\fB\-i\fR, \fB\-\-ip\fR
+This option is like
+.B \-\-dns
+in that it displays the remote host, but it displays the host in IP
+number notation.
+.TP
+\fB\-w\fR, \fB\-\-fullnames\fR
 Display full user and domain names in the output.
-.IP \fB\-x\fP
+.TP
+\fB\-x\fR, \fB\-\-system\fR
 Display the system shutdown entries and run level changes.
-.\"}}}
 .SH NOTES
-The files \fIwtmp\fP and \fIbtmp\fP might not be found. The system only
-logs information in these files if they are present. This is a local
-configuration issue. If you want the files to be used, they can be
-created with a simple \fBtouch\fP(1) command (for example,
-\fItouch /var/log/wtmp\fP).
-.\"{{{  Files
+The files
+.I wtmp
+and
+.I btmp
+might not be found.  The system only logs information in these files if
+they are present.  This is a local configuration issue.  If you want the
+files to be used, they can be created with a simple
+.BR touch (1)
+command (for example,
+.IR "touch /var/log/wtmp" ).
 .SH FILES
 /var/log/wtmp
 .br
 /var/log/btmp
-.\"}}}
-.\"{{{  Author
 .SH AUTHOR
-Miquel van Smoorenburg, miquels@cistron.nl
-.\"}}}
+.MT miquels@cistron.nl
+Miquel van Smoorenburg
+.ME
 .SH AVAILABILITY
 The last command is part of the util-linux package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
-.\"{{{  See also
+.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+Linux Kernel Archive
+.UE .
 .SH "SEE ALSO"
 .BR shutdown (8),
 .BR login (1),
 .BR init (8)
-.\"}}}