Making st.1 more descriptive about -l and fix -l in st.c.

[st.git] / st.1

diff --git a/st.1 b/st.1
index 9548c1a..29e3163 100644 (file)
--- a/st.1
+++ b/st.1
@@ -15,6 +15,8 @@ st \- simple terminal
 .IR file ]
 .RB [ \-t 
 .IR title ]
+.RB [ \-T
+.IR title ]
 .RB [ \-l
 .IR line ]
 .RB [ \-w 
@@ -37,13 +39,13 @@ st \- simple terminal
 .IR file ]
 .RB [ \-t
 .IR title ]
-.RB [ \-l
-.IR line ]
+.RB [ \-T
+.IR title ]
 .RB [ \-w
 .IR windowid ]
 .RB [ \-v ]
-.RB [ \-l
-.IR line ]
+.RB \-l
+.IR line
 .RI [ stty_args ...]
 .SH DESCRIPTION
 .B st
@@ -79,14 +81,32 @@ standard output.
 .BI \-t " title"
 defines the window title (default 'st').
 .TP
+.BI \-T " title"
+defines the window title (default 'st').
+.TP
 .BI \-w " windowid"
 embeds st within the window identified by 
 .I windowid
 .TP
 .BI \-l " line"
-use a tty line instead of a pseudo terminal.
-When this flag is used
-remaining arguments are used as flags for stty.
+use a tty
+.I line
+instead of a pseudo terminal.
+.I line
+should be a (pseudo-)serial device (e.g. /dev/ttySO on Linux for serial port
+0).
+When this flag is given
+remaining arguments are used as flags for
+.BR stty(1).
+By default st initializes the serial line to 8 bits, no parity, 1 stop bit
+and a 38400 baud rate. The speed is set by appending it as last argument
+(e.g. 'st -l 115200'). Arguments before the last one are
+.BR stty(1)
+flags. If you want to set odd parity on 115200 baud use for example 'st -l
+parenb parodd 115200'. Set the number of bits by using for example 'st -l cs7
+115200'. See
+.BR stty(1)
+for more arguments and cases.
 .TP
 .B \-v
 prints version information to stderr, then exits.