This avoids the need to double up the backslashes in some places, and
eliminates some errors reported by doclifter.
Reported-by: Eric S. Raymond <esr@thyrsus.com>
Signed-off-by: Paul Mackerras <paulus@samba.org>
.TP
.B \-T \fI<phone number>
Pass in an arbitrary string, usually a phone number, that will be
.TP
.B \-T \fI<phone number>
Pass in an arbitrary string, usually a phone number, that will be
-substituted for the \\T substitution metacharacter in a send string.
+substituted for the \eT substitution metacharacter in a send string.
.TP
.B \-U \fI<phone number 2>
Pass in a second string, usually a phone number, that will be
.TP
.B \-U \fI<phone number 2>
Pass in a second string, usually a phone number, that will be
-substituted for the \\U substitution metacharacter in a send string.
+substituted for the \eU substitution metacharacter in a send string.
This is useful when dialing an ISDN terminal adapter that requires two
numbers.
.TP
This is useful when dialing an ISDN terminal adapter that requires two
numbers.
.TP
.LP
A carriage return is normally sent following the reply string. It is not
expected in the "expect" string unless it is specifically requested by using
.LP
A carriage return is normally sent following the reply string. It is not
expected in the "expect" string unless it is specifically requested by using
-the \\r character sequence.
+the \er character sequence.
.LP
The expect sequence should contain only what is needed to identify the
string. Since it is normally stored on a disk file, it should not contain
.LP
The expect sequence should contain only what is needed to identify the
string. Since it is normally stored on a disk file, it should not contain
-SAY "Dialling your ISP...\\n"
+SAY "Dialling your ISP...\en"
-SAY "Connected, now logging in ...\\n"
+SAY "Connected, now logging in ...\en"
.br
ogin: account
.br
ssword: pass
.br
.br
ogin: account
.br
ssword: pass
.br
-SAY "Logged in OK ...\\n"
+SAY "Logged in OK ...\en"
\fIetc ...\fR
.LP
This sequence will only present the SAY strings to the user and all
\fIetc ...\fR
.LP
This sequence will only present the SAY strings to the user and all
.br
\&'Callback login:' call_back_ID
.br
.br
\&'Callback login:' call_back_ID
.br
It may be used to cycle through the available transmission rates on
the remote until you are able to receive a valid login prompt.
The break sequence may be embedded into the send string using the
It may be used to cycle through the available transmission rates on
the remote until you are able to receive a valid login prompt.
The break sequence may be embedded into the send string using the
.SH ESCAPE SEQUENCES
The expect and reply strings may contain escape sequences. All of the
sequences are legal in the reply string. Many are legal in the expect.
.SH ESCAPE SEQUENCES
The expect and reply strings may contain escape sequences. All of the
sequences are legal in the reply string. Many are legal in the expect.
send the return character. This sequence may either be a pair of apostrophe
or quote characters.
.TP
send the return character. This sequence may either be a pair of apostrophe
or quote characters.
.TP
represents a backspace character.
.TP
represents a backspace character.
.TP
Suppresses the newline at the end of the reply string. This is the only
method to send a string without a trailing return character. It must
be at the end of the send string. For example,
Suppresses the newline at the end of the reply string. This is the only
method to send a string without a trailing return character. It must
be at the end of the send string. For example,
-the sequence hello\\c will simply send the characters h, e, l, l, o.
+the sequence hello\ec will simply send the characters h, e, l, l, o.
.I (not valid in expect.)
.TP
.I (not valid in expect.)
.TP
Delay for one second. The program uses sleep(1) which will delay to a
maximum of one second.
.I (not valid in expect.)
.TP
Delay for one second. The program uses sleep(1) which will delay to a
maximum of one second.
.I (not valid in expect.)
.TP
Insert a BREAK
.I (not valid in expect.)
.TP
Insert a BREAK
.I (not valid in expect.)
.TP
Send a newline or linefeed character.
.TP
Send a newline or linefeed character.
.TP
-.B \\\\N
-Send a null character. The same sequence may be represented by \\0.
+.B \eN
+Send a null character. The same sequence may be represented by \e0.
.I (not valid in expect.)
.TP
.I (not valid in expect.)
.TP
Pause for a fraction of a second. The delay is 1/10th of a second.
.I (not valid in expect.)
.TP
Pause for a fraction of a second. The delay is 1/10th of a second.
.I (not valid in expect.)
.TP
Suppress writing the string to the SYSLOG file. The string ?????? is
written to the log in its place.
.I (not valid in expect.)
.TP
Suppress writing the string to the SYSLOG file. The string ?????? is
written to the log in its place.
.I (not valid in expect.)
.TP
Send or expect a carriage return.
.TP
Send or expect a carriage return.
.TP
Represents a space character in the string. This may be used when it
is not desirable to quote the strings which contains spaces. The
Represents a space character in the string. This may be used when it
is not desirable to quote the strings which contains spaces. The
-sequence 'HI TIM' and HI\\sTIM are the same.
+sequence 'HI TIM' and HI\esTIM are the same.
Send or expect a tab character.
.TP
Send or expect a tab character.
.TP
Send the phone number string as specified with the \fI\-T\fR option
.I (not valid in expect.)
.TP
Send the phone number string as specified with the \fI\-T\fR option
.I (not valid in expect.)
.TP
Send the phone number 2 string as specified with the \fI\-U\fR option
.I (not valid in expect.)
.TP
Send the phone number 2 string as specified with the \fI\-U\fR option
.I (not valid in expect.)
.TP
Send or expect a backslash character.
.TP
Send or expect a backslash character.
.TP
Collapse the octal digits (ddd) into a single ASCII character and send that
character.
.I (some characters are not valid in expect.)
Collapse the octal digits (ddd) into a single ASCII character and send that
character.
.I (some characters are not valid in expect.)
.PP
An options file is parsed into a series of words, delimited by
whitespace. Whitespace can be included in a word by enclosing the
.PP
An options file is parsed into a series of words, delimited by
whitespace. Whitespace can be included in a word by enclosing the
-word in double-quotes ("). A backslash (\\) quotes the following character.
+word in double-quotes ("). A backslash (\e) quotes the following character.
A hash (#) starts a comment, which continues until the end of the
line. There is no restriction on using the \fIfile\fR or \fIcall\fR
options within an options file.
A hash (#) starts a comment, which continues until the end of the
line. There is no restriction on using the \fIfile\fR or \fIcall\fR
options within an options file.
.br
"name:" "^Umyuserid"
.br
.br
"name:" "^Umyuserid"
.br