From c8c88a4b60ebb8dd6f330ce9c0bc75b222ef277b Mon Sep 17 00:00:00 2001 From: "Steffen (Daode) Nurpmeso" Date: Wed, 5 Jul 2017 13:17:37 +0200 Subject: [PATCH] nail.1: move IMAP section further upwards --- nail.1 | 242 ++++++++++++++++++++++++++++++++--------------------------------- 1 file changed, 121 insertions(+), 121 deletions(-) diff --git a/nail.1 b/nail.1 index e8fd4cb2d..2df08bcd5 100644 --- a/nail.1 +++ b/nail.1 @@ -12684,123 +12684,6 @@ $ cat -v .\" }}} . . -.\" .Sh "SEE ALSO" {{{ -.Sh "SEE ALSO" -. -.Xr bogofilter 1 , -.Xr gpg 1 , -.Xr more 1 , -.Xr newaliases 1 , -.Xr openssl 1 , -.Xr sendmail 1 , -.Xr sh 1 , -.Xr spamassassin 1 , -.Xr iconv 3 , -.Xr setlocale 3 , -.Xr aliases 5 , -.Xr termcap 5 , -.Xr terminfo 5 , -.Xr locale 7 , -.Xr mailaddr 7 , -.Xr re_format 7 , -.Xr mailwrapper 8 , -.Xr sendmail 8 -.\" }}} -. -. -.\" .Sh HISTORY {{{ -.Sh HISTORY -. -M. Douglas McIlroy writes in his article -.Dq A Research UNIX Reader: Annotated Excerpts \ -from the Programmer's Manual, 1971-1986 -that a -.Xr mail 1 -command already appeared in First Edition -.Ux -in 1971: -. -.Bd -ragged -offset indent -Electronic mail was there from the start. -Never satisfied with its exact behavior, everybody touched it at one -time or another: to assure the safety of simultaneous access, to improve -privacy, to survive crashes, to exploit uucp, to screen out foreign -freeloaders, or whatever. -Not until v7 did the interface change (Thompson). -Later, as mail became global in its reach, Dave Presotto took charge and -brought order to communications with a grab-bag of external networks -(v8). -.Ed -. -.Pp -.Bx -Mail was written in 1978 by Kurt Shoens and developed as part of the -.Bx -.Ux -distribution until 1995. -Mail has then seen further development in open source -.Bx -variants, noticeably by Christos Zoulas in -.Pf Net Bx . -Based upon this Nail, later Heirloom Mailx, was developed by Gunnar -Ritter in the years 2000 until 2008. -Since 2012 S-nail is maintained by Steffen (Daode) Nurpmeso. -This man page is derived from -.Dq The Mail Reference Manual -that was originally written by Kurt Shoens. -.\" }}} -. -. -.Sh AUTHORS -. -.An "Kurt Shoens" , -.An "Edward Wang" , -.An "Keith Bostic" , -.An "Christos Zoulas" , -.An "Gunnar Ritter" , -.An "Steffen Nurpmeso" . -. -.Pp -The variables -.Va contact-mail -and -.Va contact-web -provide contact addresses: -.Pp -.\" v15-compat: drop eval as `mail' will expand variable? -.Dl ? echo $contact-web; eval mail $contact-mail -. -. -.\" .Sh CAVEATS {{{ -.Sh CAVEATS -. -\*(ID Interrupting an operation via -.Dv \&\&SIGINT -aka -.Ql control-C -from anywhere else but a command prompt is very problematic and likely -to leave the program in an undefined state: many library functions -cannot deal with the -.Fn siglongjmp 3 -that this software (still) performs; even though efforts have been taken -to address this, no sooner but in v15 it will have been worked out: -interruptions have not been disabled in order to allow forceful breakage -of hanging network connections, for example (all this is unrelated to -.Va ignore ) . -. -.Pp -The SMTP and POP3 protocol support of \*(UA is very basic. -Also, if it fails to contact its upstream SMTP server, it will not make -further attempts to transfer the message at a later time (setting -.Va save -and -.Va sendwait -may be useful). -If this is a concern, it might be better to set up a local SMTP server -that is capable of message queuing. -.\" }}} -. -. .\" .Sh "IMAP CLIENT" {{{ .Sh "IMAP CLIENT" . @@ -12910,7 +12793,7 @@ Not all IMAP servers support this command. . .Mx .It Ic imapcodec -Perform IMAP path transformations on all the given strings. +Perform IMAP path transformations. Supports .Cm vput (see @@ -12923,9 +12806,9 @@ normalizes hierarchy delimiters (see .Va imap-delim ) and converts the strings from the locale .Va ttycharset -to the internationalised variant used by IMAP, +to the internationalized variant used by IMAP, .Ar d[ecode] -does the reverse operation. +performs the reverse operation. .El . . @@ -12984,7 +12867,7 @@ it is not safe to make assumptions about them. .It Va imap-delim-USER@HOST , imap-delim-HOST , imap-delim The hierarchy separator used by the IMAP server. Whenever an IMAP path is specified it will undergo normalization. -One of the normalization steps is the squeeze and adjustment of +One of the normalization steps is the squeezing and adjustment of hierarchy separators. If this variable is set, any occurrence of any character of the given value that exists in the path will be replaced by the first member of @@ -13025,6 +12908,123 @@ and is not used if the session is already encrypted by the IMAPS method. .\" }}} . . +.\" .Sh "SEE ALSO" {{{ +.Sh "SEE ALSO" +. +.Xr bogofilter 1 , +.Xr gpg 1 , +.Xr more 1 , +.Xr newaliases 1 , +.Xr openssl 1 , +.Xr sendmail 1 , +.Xr sh 1 , +.Xr spamassassin 1 , +.Xr iconv 3 , +.Xr setlocale 3 , +.Xr aliases 5 , +.Xr termcap 5 , +.Xr terminfo 5 , +.Xr locale 7 , +.Xr mailaddr 7 , +.Xr re_format 7 , +.Xr mailwrapper 8 , +.Xr sendmail 8 +.\" }}} +. +. +.\" .Sh HISTORY {{{ +.Sh HISTORY +. +M. Douglas McIlroy writes in his article +.Dq A Research UNIX Reader: Annotated Excerpts \ +from the Programmer's Manual, 1971-1986 +that a +.Xr mail 1 +command already appeared in First Edition +.Ux +in 1971: +. +.Bd -ragged -offset indent +Electronic mail was there from the start. +Never satisfied with its exact behavior, everybody touched it at one +time or another: to assure the safety of simultaneous access, to improve +privacy, to survive crashes, to exploit uucp, to screen out foreign +freeloaders, or whatever. +Not until v7 did the interface change (Thompson). +Later, as mail became global in its reach, Dave Presotto took charge and +brought order to communications with a grab-bag of external networks +(v8). +.Ed +. +.Pp +.Bx +Mail was written in 1978 by Kurt Shoens and developed as part of the +.Bx +.Ux +distribution until 1995. +Mail has then seen further development in open source +.Bx +variants, noticeably by Christos Zoulas in +.Pf Net Bx . +Based upon this Nail, later Heirloom Mailx, was developed by Gunnar +Ritter in the years 2000 until 2008. +Since 2012 S-nail is maintained by Steffen (Daode) Nurpmeso. +This man page is derived from +.Dq The Mail Reference Manual +that was originally written by Kurt Shoens. +.\" }}} +. +. +.Sh AUTHORS +. +.An "Kurt Shoens" , +.An "Edward Wang" , +.An "Keith Bostic" , +.An "Christos Zoulas" , +.An "Gunnar Ritter" , +.An "Steffen Nurpmeso" . +. +.Pp +The variables +.Va contact-mail +and +.Va contact-web +provide contact addresses: +.Pp +.\" v15-compat: drop eval as `mail' will expand variable? +.Dl ? echo $contact-web; eval mail $contact-mail +. +. +.\" .Sh CAVEATS {{{ +.Sh CAVEATS +. +\*(ID Interrupting an operation via +.Dv \&\&SIGINT +aka +.Ql control-C +from anywhere else but a command prompt is very problematic and likely +to leave the program in an undefined state: many library functions +cannot deal with the +.Fn siglongjmp 3 +that this software (still) performs; even though efforts have been taken +to address this, no sooner but in v15 it will have been worked out: +interruptions have not been disabled in order to allow forceful breakage +of hanging network connections, for example (all this is unrelated to +.Va ignore ) . +. +.Pp +The SMTP and POP3 protocol support of \*(UA is very basic. +Also, if it fails to contact its upstream SMTP server, it will not make +further attempts to transfer the message at a later time (setting +.Va save +and +.Va sendwait +may be useful). +If this is a concern, it might be better to set up a local SMTP server +that is capable of message queuing. +.\" }}} +. +. .Sh BUGS . After deleting some message of a POP3 mailbox the header summary falsely -- 2.11.4.GIT