"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "nail.1" between
s-nail-14.9.21.tar.xz and s-nail-14.9.22.tar.xz

About: S-nail is a mail processing system intended to provide the functionality of the POSIX mailx command and offers extensions for line editing, IDNA, MIME, S/MIME, SMTP and POP3 (and IMAP). It is usable as a mail batch language.

nail.1  (s-nail-14.9.21.tar.xz):nail.1  (s-nail-14.9.22.tar.xz)
S-NAIL(1) BSD General Commands Manual S-NAIL(1) S-NAIL(1) BSD General Commands Manual S-NAIL(1)
NAME NAME
S-nail [v14.9.21] — send and receive Internet mail S-nail [v14.9.22] — send and receive Internet mail
SYNOPSIS SYNOPSIS
s-nail [-DdEFinv~#] [-: spec] [-A account] [:-a attachment:] [:-b bcc-addr: ] [:-C "field: body":] s-nail [-DdEFinv~#] [-: spec] [-A account] [:-a attachment:] [:-b bcc-addr: ] [:-C "field: body":]
[:-c cc-addr:] [-M type | -m file | -q file | -t] [-r from-addr] [:- S var[=value]:] [-s subject] [:-c cc-addr:] [-M type | -m file | -q file | -t] [-r from-addr] [:- S var[=value]:] [-s subject]
[:-T "field: addr":] [:-X cmd:] [:-Y cmd:] [-.] :to-addr: [-- :mta-o ption:] [:-T "field: addr":] [:-X cmd:] [:-Y cmd:] [-.] :to-addr: [-- :mta-o ption:]
s-nail [-DdEeHiNnRv~#] [-: spec] [-A account] [:-C "field: body":] [-L spec ] [-r from-addr] s-nail [-DdEeHiNnRv~#] [-: spec] [-A account] [:-C "field: body":] [-L spec ] [-r from-addr]
[:-S var[=value]:] [-u user] [:-X cmd:] [:-Y cmd:] [-- :mta-option:] [:-S var[=value]:] [-u user] [:-X cmd:] [:-Y cmd:] [-- :mta-option:]
s-nail [-DdEeHiNnRv~#] [-: spec] [-A account] [:-C "field: body":] -f [-L s pec] [-r from-addr] s-nail [-DdEeHiNnRv~#] [-: spec] [-A account] [:-C "field: body":] -f [-L s pec] [-r from-addr]
[:-S var[=value]:] [:-X cmd:] [:-Y cmd:] [file] [-- :mta-option:] [:-S var[=value]:] [:-X cmd:] [:-Y cmd:] [file] [-- :mta-option:]
skipping to change at line 169 skipping to change at line 169
When this command line option is used the given single addressee fro m-addr will be assigned to the When this command line option is used the given single addressee fro m-addr will be assigned to the
internal variable from, but in addition the command line option -f f rom-addr will be passed to a internal variable from, but in addition the command line option -f f rom-addr will be passed to a
file-based mta whenever a message is sent. Shall from-addr include a user name the address compo- file-based mta whenever a message is sent. Shall from-addr include a user name the address compo-
nents will be separated and the name part will be passed to a file-b ased mta individually via -F nents will be separated and the name part will be passed to a file-b ased mta individually via -F
name. Even though not a recipient the ‘shquote’ expandaddr flag is supported. name. Even though not a recipient the ‘shquote’ expandaddr flag is supported.
If an empty string is passed as from-addr then the content of the va riable from (or, if that contains If an empty string is passed as from-addr then the content of the va riable from (or, if that contains
multiple addresses, sender) will be evaluated and used for this purp ose whenever the file-based mta multiple addresses, sender) will be evaluated and used for this purp ose whenever the file-based mta
is contacted. By default, without -r that is, neither -f nor -F com mand line options are used when is contacted. By default, without -r that is, neither -f nor -F com mand line options are used when
contacting a file-based MTA, unless this automatic deduction is enfo contacting a file-based MTA, unless this automatic deduction is enfo
rced by seting the internal vari- rced by setting the internal
able r-option-implicit. variable r-option-implicit.
Remarks: many default installations and sites disallow overriding th e local user identity like this Remarks: many default installations and sites disallow overriding th e local user identity like this
unless either the MTA has been configured accordingly or the user is member of a group with special unless either the MTA has been configured accordingly or the user is member of a group with special
privileges. Passing an invalid address will cause an error. privileges. Passing an invalid address will cause an error.
-S var[=value], --set=.. -S var[=value], --set=..
set (or, with a prefix string ‘no’, as documented in INTERNAL VARIAB LES, unset) variable and option- set (or, with a prefix string ‘no’, as documented in INTERNAL VARIAB LES, unset) variable and option-
ally assign value, if supported; [v15 behaviour may differ] the enti re expression is evaluated as if ally assign value, if supported; [v15 behaviour may differ] the enti re expression is evaluated as if
specified within dollar-single-quotes (see Shell-style argument quot ing) if the internal variable specified within dollar-single-quotes (see Shell-style argument quot ing) if the internal variable
v15-compat is set. If the operation fails the program will exit if any of errexit or posix are set. v15-compat is set. If the operation fails the program will exit if any of errexit or posix are set.
skipping to change at line 1939 skipping to change at line 1939
been specified then the usual search for a visible message is perform ed, as documented for Message been specified then the usual search for a visible message is perform ed, as documented for Message
list arguments, showing only the next input prompt if the search fail s. Deleted messages will neither list arguments, showing only the next input prompt if the search fail s. Deleted messages will neither
be saved in the secondary mailbox MBOX nor will they be available for most other commands. If the be saved in the secondary mailbox MBOX nor will they be available for most other commands. If the
autoprint variable is set, the new “dot” or the last message restored , respectively, is automatically autoprint variable is set, the new “dot” or the last message restored , respectively, is automatically
typed; also see dp, dt. typed; also see dp, dt.
digmsg digmsg
[Only new quoting rules] Digging (information out of) messages is pos sible through digmsg objects, [Only new quoting rules] Digging (information out of) messages is pos sible through digmsg objects,
which can be created for the given message number; in Compose mode th e hyphen-minus ‘-’ will instead which can be created for the given message number; in Compose mode th e hyphen-minus ‘-’ will instead
open the message that is being composed. If a hyphen-minus is given as the optional third argument open the message that is being composed. If a hyphen-minus is given as the optional third argument
then output will be generated on the standard output channel instead of being subject to consumation then output will be generated on the standard output channel instead of being subject to consumption
by the readsh (here better than read or readall) command. by the readsh (here better than read or readall) command.
The objects may be removed again by giving the same identifier used f or creation; this step could be The objects may be removed again by giving the same identifier used f or creation; this step could be
omitted: objects will be automatically closed when the active folder (mailbox) or the compose mode is omitted: objects will be automatically closed when the active folder (mailbox) or the compose mode is
left, respectively. In all other use cases the second argument is an object identifier, and the third left, respectively. In all other use cases the second argument is an object identifier, and the third
and all following arguments are interpreted as via ~^ (see COMMAND ES CAPES): and all following arguments are interpreted as via ~^ (see COMMAND ES CAPES):
? vput = msgno; digmsg create $msgno ? vput = msgno; digmsg create $msgno
? digmsg $msgno header list; readall x; echon $x ? digmsg $msgno header list; readall x; echon $x
210 Subject From To Message-ID References In-Reply-To 210 Subject From To Message-ID References In-Reply-To
skipping to change at line 4303 skipping to change at line 4303
For a file-based MTA it may be necessary to set mta-argv0 in in order to choose the right target of a For a file-based MTA it may be necessary to set mta-argv0 in in order to choose the right target of a
modern mailwrapper(8) environment. It will be passed command line ar guments from several possible modern mailwrapper(8) environment. It will be passed command line ar guments from several possible
sources: from the variable mta-arguments if set, from the command lin e if given and the variable sources: from the variable mta-arguments if set, from the command lin e if given and the variable
expandargv allows their use. Argument processing of the MTA will be terminated with a -- separator. expandargv allows their use. Argument processing of the MTA will be terminated with a -- separator.
The otherwise occurring implicit usage of the following MTA command l ine arguments can be disabled by The otherwise occurring implicit usage of the following MTA command l ine arguments can be disabled by
setting the boolean variable mta-no-default-arguments (which will als o disable passing -- to the MTA): setting the boolean variable mta-no-default-arguments (which will als o disable passing -- to the MTA):
-i (for not treating a line with only a dot ‘.’ character as the end of input), -m (shall the variable -i (for not treating a line with only a dot ‘.’ character as the end of input), -m (shall the variable
metoo be set) and -v (if the verbose variable is set); in conjunction with the -r command line option metoo be set) and -v (if the verbose variable is set); in conjunction with the -r command line option
S-nail will also (not) pass -f as well as possibly -F. or r-option-implicit -f as well as possibly -F will (not) be passed.
[Option]ally S-nail can send mail over SMTP aka SUBMISSION network co nnections to a single defined [Option]ally S-nail can send mail over SMTP aka SUBMISSION network co nnections to a single defined
smart host by setting this variable to a SMTP or SUBMISSION URL (see On URL syntax and credential smart host by setting this variable to a SMTP or SUBMISSION URL (see On URL syntax and credential
lookup). An authentication scheme can be specified via the variable chain smtp-auth. Encrypted net- lookup). An authentication scheme can be specified via the variable chain smtp-auth. Encrypted net-
work connections are [Option]ally available, the section Encrypted ne twork communication should give work connections are [Option]ally available, the section Encrypted ne twork communication should give
an overview and provide links to more information on this. Note that with some mail providers it may an overview and provide links to more information on this. Note that with some mail providers it may
be necessary to set the smtp-hostname variable in order to use a spec ific combination of from, be necessary to set the smtp-hostname variable in order to use a spec ific combination of from,
hostname and mta. Network communication socket timeouts are configur able via socket-connect-timeout. hostname and mta. Network communication socket timeouts are configur able via socket-connect-timeout.
All generated network traffic may be proxied over a SOCKS socks-proxy , it can be logged by setting All generated network traffic may be proxied over a SOCKS socks-proxy , it can be logged by setting
verbose twice. The following SMTP variants may be used: verbose twice. The following SMTP variants may be used:
skipping to change at line 4522 skipping to change at line 4522
mand name as the third argument, followed by the tokenized command li ne as parsed in the remaining mand name as the third argument, followed by the tokenized command li ne as parsed in the remaining
arguments, the first of which is the original unexpanded command name ; i.e., one may do ‘shift 4’ and arguments, the first of which is the original unexpanded command name ; i.e., one may do ‘shift 4’ and
will then be able to access the positional parameters as usual via *, #, 1 etc. will then be able to access the positional parameters as usual via *, #, 1 etc.
on-main-loop-tick on-main-loop-tick
This hook will be called whenever the program's main event loop is ab out to read the next input line. This hook will be called whenever the program's main event loop is ab out to read the next input line.
Note variable and other changes it performs are not scoped as via loc alopts! Note variable and other changes it performs are not scoped as via loc alopts!
on-program-exit on-program-exit
This hook will be called when the program exits, whether via exit or quit, or because the send mode is This hook will be called when the program exits, whether via exit or quit, or because the send mode is
done. done. Note: this runs late and so terminal settings etc. are already teared down.
on-resend-cleanup on-resend-cleanup
[v15 behaviour may differ] Identical to on-compose-cleanup, but is on ly triggered by resend. [v15 behaviour may differ] Identical to on-compose-cleanup, but is on ly triggered by resend.
on-resend-enter on-resend-enter
[v15 behaviour may differ] Identical to on-compose-enter, but is only triggered by resend; currently [v15 behaviour may differ] Identical to on-compose-enter, but is only triggered by resend; currently
there is no digmsg support, for example. there is no digmsg support, for example.
page (Boolean) If set, each message feed through the command given for pip e is followed by a formfeed char- page (Boolean) If set, each message feed through the command given for pip e is followed by a formfeed char-
acter ‘\f’. acter ‘\f’.
skipping to change at line 4697 skipping to change at line 4697
‘.. ’. ‘.. ’.
quiet quiet
(Boolean) Suppresses the printing of the version when first invoked. (Boolean) Suppresses the printing of the version when first invoked.
quote quote
If set messages processed by variants of followup and reply will star t with the original message, If set messages processed by variants of followup and reply will star t with the original message,
lines of which prefixed by indentprefix, taking into account quote-ch ars and quote-fold. No headers lines of which prefixed by indentprefix, taking into account quote-ch ars and quote-fold. No headers
will be quoted when set without value or for ‘noheading’, for ‘header s’ the ‘type’ headerpick selec- will be quoted when set without value or for ‘noheading’, for ‘header s’ the ‘type’ headerpick selec-
tion will be included in the quote, ‘allbodies’ embeds the (body) con tents of all MIME parts, and tion will be included in the quote, ‘allbodies’ embeds the (body) con tents of all MIME parts, and
‘allheaders’ als includes all headers. The quoted message will be en closed by the expansions of ‘allheaders’ also includes all headers. The quoted message will be e nclosed by the expansions of
quote-inject-head and quote-inject-tail. Also see quote-add-cc, quot e-as-attachment and ~Q, one of quote-inject-head and quote-inject-tail. Also see quote-add-cc, quot e-as-attachment and ~Q, one of
the COMMAND ESCAPES. the COMMAND ESCAPES.
quote-add-cc quote-add-cc
(Boolean) Whether senders of messages quoted via ~Q shall be made mem bers of the carbon copies ‘Cc:’ (Boolean) Whether senders of messages quoted via ~Q shall be made mem bers of the carbon copies ‘Cc:’
list. list.
quote-as-attachment quote-as-attachment
(Boolean) Add the original message in its entirety as a ‘message/rfc8 22’ MIME attachment when replying (Boolean) Add the original message in its entirety as a ‘message/rfc8 22’ MIME attachment when replying
to a message. Note this works regardless of the setting of quote. to a message. Note this works regardless of the setting of quote.
skipping to change at line 6410 skipping to change at line 6410
#to = /tmp/OUT #to = /tmp/OUT
confirm = always confirm = always
chainreplyto = true chainreplyto = true
multiedit = false multiedit = false
thread = true thread = true
quiet = true quiet = true
annotate = true annotate = true
Patches can also be send directly, for example: Patches can also be send directly, for example:
$ git mail-patch HEAD^ | $ git format-patch -M --stdout HEAD^ |
s-nail -Athe-account-you-need -t RECEIVER s-nail -A the-account-you-need -t RECEIVER
Howto handle stale dotlock files Howto handle stale dotlock files
folder sometimes fails to open MBOX mail databases because creation of dotl ock files is impossible due to folder sometimes fails to open MBOX mail databases because creation of dotl ock files is impossible due to
existing but unowned lock files. S-nail does not offer an option to deal w ith those files, because it is existing but unowned lock files. S-nail does not offer an option to deal w ith those files, because it is
considered a site policy what counts as unowned, and what not. The site po licy is usually defined by admin- considered a site policy what counts as unowned, and what not. The site po licy is usually defined by admin-
istrator(s), and expressed in the configuration of a locally installed MTA (for example Postfix istrator(s), and expressed in the configuration of a locally installed MTA (for example Postfix
‘stale_lock_time=500s’). Therefore the suggestion: ‘stale_lock_time=500s’). Therefore the suggestion:
$ </dev/null s-nail -s 'MTA: be no frog, handle lock' $LOGNAME $ </dev/null s-nail -s 'MTA: be no frog, handle lock' $LOGNAME
skipping to change at line 6628 skipping to change at line 6628
Including the verbose output of the command version may be helpful: Including the verbose output of the command version may be helpful:
? wysh set escape=! verbose; vput version xy; unset verbose;\ ? wysh set escape=! verbose; vput version xy; unset verbose;\
eval mail $contact-mail eval mail $contact-mail
Bug subject Bug subject
!I xy !I xy
!. !.
Information on the web at ‘$ s-nail -X 'echo $contact-web; x'’. Information on the web at ‘$ s-nail -X 'echo $contact-web; x'’.
BSD January 21, 2021 BSD BSD February 24, 2021 BSD
 End of changes. 8 change blocks. 
10 lines changed or deleted 10 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)