From c9b2863e7e7331f381a587756a403cbb6b19e115 Mon Sep 17 00:00:00 2001
From: Mattias Andrée <maandree@member.fsf.org>
Date: Sat, 19 Dec 2015 15:34:50 +0100
Subject: doc: does not acquire the tty
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Mattias Andrée <maandree@member.fsf.org>
---
 doc/man/sleeping-getty.8 | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

(limited to 'doc/man')

diff --git a/doc/man/sleeping-getty.8 b/doc/man/sleeping-getty.8
index a40772c..f20ed92 100644
--- a/doc/man/sleeping-getty.8
+++ b/doc/man/sleeping-getty.8
@@ -24,10 +24,29 @@ works on VT:s, not TTY:s. It cannot wait for a serial console to
 become, active, only virtual terminals.
 .SH EXAMPLE
 .nf
-/sbin/\fBsleeping-getty\fP \fI15\fP /sbin/got tty\fI15\fP TERM=linux
-/sbin/\fBsleeping-getty\fP \fI16\fP /sbin/got tty\fI16\fP TERM=linux
-/sbin/\fBsleeping-getty\fP \fI20\fP /sbin/agetty -8 -s 38400 tty\fI20\fP linux
+/sbin/\fBsleeping\-getty\fP \fI15\fP /sbin/got tty\fI15\fP TERM=linux
+/sbin/\fBsleeping\-getty\fP \fI16\fP /sbin/got tty\fI16\fP TERM=linux
+/sbin/\fBsleeping\-getty\fP \fI20\fP /sbin/agetty -8 -s 38400 tty\fI20\fP linux
 .fi
+.SH NOTES
+.B sleeping\-getty
+does not acquire the TTY. That would be a waste of CPU cycles.
+This means, if naïvely used, that if you start your computer,
+log in on
+.BR tty1 ,
+and start
+.BR X ,
+and have
+.B startx
+configured to start
+.B X
+on the next available VT.
+.B X
+will start on VT\ 2. This is probably not want you want.
+Instead you should edit
+.B startx
+to ensure that a VT lower than a preferred number
+(customarily 7) will not be used.
 .SH RATIONALE
 It is nice to have a score or two of TTY:s available. However,
 starting them, can require some unnecessary CPU time and will
-- 
cgit v1.2.3-70-g09d2