]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
agetty: update man page and usage()
authorKarel Zak <kzak@redhat.com>
Mon, 3 Jun 2013 08:04:43 +0000 (10:04 +0200)
committerKarel Zak <kzak@redhat.com>
Fri, 21 Jun 2013 09:23:57 +0000 (11:23 +0200)
 - baud_rate is optional
 - agetty has been rewritten 2 years ago, so don't blame original
   authors in the man page

Signed-off-by: Karel Zak <kzak@redhat.com>
term-utils/agetty.8
term-utils/agetty.c

index 64a1dd2896f2030e8e991f27c2ba8bd342af8df3..2126a7d52d48fb98ccc223d9fe5ad75b571d0af4 100644 (file)
@@ -3,15 +3,10 @@
 agetty \- alternative Linux getty
 
 .SH SYNOPSIS
-.BR "agetty " [\-8chiLmnsUw]
-.RI "[\-a " user ]
-.RI "[\-f " issue_file ]
-.RI "[\-H " login_host ]
-.RI "[\-I " init ]
-.RI "[\-l " login_program ]
-.RI "[\-t " timeout ]
+.B agetty
+.RB [ options ]
 .I port
-.I baud_rate,...
+.RI [ baud_rate ...]
 .RI [ term ]
 
 .SH DESCRIPTION
@@ -74,10 +69,16 @@ the list, which is treated as if it were circular.
 .sp
 Baud rates should be specified in descending order, so that the
 null character (Ctrl\-@) can also be used for baud rate switching.
+.sp
+This argument is optional and unnecessary for virtual terminals.
+The default for serial terminals is '9600'.
 .TP
 term
 The value to be used for the TERM environment variable. This overrides
 whatever init(8) may have set, and is inherited by login and the shell.
+.sp
+The default is 'vt100', or 'linux' for Linux on virtual terminal, or 'hurd'
+for GNU Hurd on virtual terminal.
 .SH OPTIONS
 .na
 .nf
@@ -376,19 +377,19 @@ written to the console device or reported via the syslog(3) facility.
 Error messages are produced if the \fIport\fP argument does not
 specify a terminal device; if there is no utmp entry for the
 current process (System V only); and so on.
-.SH AUTHOR(S)
-.na
-.nf
-W.Z. Venema <wietse@wzv.win.tue.nl>
-Eindhoven University of Technology
-Department of Mathematics and Computer Science
-Den Dolech 2, P.O. Box 513, 5600 MB Eindhoven, The Netherlands
-
-Peter Orbaek <poe@daimi.aau.dk>
-Linux port and more options. Still maintains the code.
-
-Eric Rasmussen <ear@usfirst.org>
-Added \-f option to display custom login messages on different terminals.
+.SH AUTHORS
+.UR werner@suse.de
+Werner Fink
+.UE
+.br
+.UR kzak@redhat.com
+Karel Zak
+.UE
+.sp
+The original
+.B agetty
+for serial terminals was written by W.Z. Venema <wietse@wzv.win.tue.nl>
+and ported to Linux by Peter Orbaek <poe@daimi.aau.dk>.
 
 .SH AVAILABILITY
 The agetty command is part of the util-linux package and is available from
index a23cf6dc278b9338b68d204963721a331e6c1b6b..8a0a435df6b48158f6a804b55b3822fcd4bf952e 100644 (file)
@@ -1633,7 +1633,7 @@ static speed_t bcode(char *s)
 static void __attribute__ ((__noreturn__)) usage(FILE *out)
 {
        fputs(USAGE_HEADER, out);
-       fprintf(out, _(" %1$s [options] line baud_rate,... [termtype]\n"
+       fprintf(out, _(" %1$s [options] line [baud_rate,...] [termtype]\n"
                       " %1$s [options] baud_rate,... line [termtype]\n"), program_invocation_short_name);
        fputs(USAGE_OPTIONS, out);
        fputs(_(" -8, --8bits                assume 8-bit tty\n"), out);