diff options
Diffstat (limited to 'fetchmail.man')
| -rw-r--r-- | fetchmail.man | 32 |
1 files changed, 19 insertions, 13 deletions
diff --git a/fetchmail.man b/fetchmail.man index 70e9c6ba..c1fedc0d 100644 --- a/fetchmail.man +++ b/fetchmail.man @@ -1320,26 +1320,29 @@ There are four kinds of tokens: grammar keywords, numbers A quoted string is bounded by double quotes and may contain whitespace (and quoted digits are treated as a string). Note that quoted strings will also contain line feed characters if they run across -two or more lines - so be sure that your strings are not word-wrapped -unless you want the embedded CR or LF characters. +two or more lines, unless you use a backslash to join lines (see below). An unquoted string is any whitespace-delimited token that is neither numeric, string quoted nor contains the special characters ',', ';', ':', or '='. .PP Any amount of whitespace separates tokens in server entries, but is -otherwise ignored. You may use escapes (\en for LF, \et for HT, -\&\eb for BS, \er for CR, \e\fInnn\fP for decimal (where nnn cannot start -with a 0), \e0\fIooo\fP for octal, and \ex\fIhh\fP for hex) to embed -non-printable characters or string delimiters in strings. +otherwise ignored. You may use backslash escape sequences (\en for LF, +\&\et for HT, \&\eb for BS, \er for CR, \e\fInnn\fP for decimal (where +nnn cannot start with a 0), \e0\fIooo\fP for octal, and \ex\fIhh\fP for +hex) to embed non-printable characters or string delimiters in strings. +In quoted strings, a backslash at the very end of a line will cause the +backslash itself and the line feed (LF or NL, new line) character to be +ignored, so that you can wrap long strings. Without the backslash at the +line end, the line feed character would become part of the string. .PP .B Warning: -while these resemble C-style escape sequences, fetchmail only supports -these seven styles. C supports more escape sequences that consist of -backslash (\e) and a single character, but does not support decimal -codes and does not require the leading 0 in octal notation. Example: -fetchmail interprets \e233 the same as \exE9 (Latin small letter e -with acute), where C would interpret \e233 as octal 0233 = \ex9B (CSI, -control sequence introducer). +while these resemble C-style escape sequences, they are not the same. +fetchmail only supports these eight styles. C supports more escape +sequences that consist of backslash (\e) and a single character, but +does not support decimal codes and does not require the leading 0 in +octal notation. Example: fetchmail interprets \e233 the same as \exE9 +(Latin small letter e with acute), where C would interpret \e233 as +octal 0233 = \ex9B (CSI, control sequence introducer). .PP Each server entry consists of one of the keywords 'poll' or 'skip', followed by a server name, followed by server options, followed by any @@ -2427,6 +2430,9 @@ Interactively entered passwords are truncated after 63 characters. If you really need to use a longer password, you will have to use a configuration file. .PP +A backslash as the last character of a configuration file will be +flagged as a syntax error rather than ignored. +.PP Send comments, bug reports, gripes, and the like to the fetchmail-devel list <fetchmail-devel@lists.berlios.de>. An HTML FAQ is available at the fetchmail home page; surf to |