Differences

This shows you the differences between two versions of the page.

--- s-mailx [2022/02/07 17:43] – created zilog
+++ s-mailx [2022/02/10 18:50] – editted feature list zilog
@@ Line 5: / Line 5: @@
 ===== Documentation and Features =====
-The s-mailx(1) manpage ((use ''$ man s-nail'' to ensure you are reading s-mailx documentation)) is the best place to learn all it's features but the standouts are:
+The s-mailx manpage, ''s-nail(1)''((the s-nail(1) manpage also available in html format on the project's website)), is very detailed and the best place to learn about its features but the standouts are:
-  * all of Heirloom-mailx features: POP3/IMAP/SMTP, folder hooks, macros, threading, etc.
+  * all Heirloom-mailx features: POP3/IMAP/SMTP, folder hooks, macros, threading, etc.
   * Maildir support
+  * readline (cmd history)
   * optional coloration
   * enhanced spam filtering
@@ Line 21: / Line 22: @@
 ==== Configuration ====
-The default user configuration file for S-mailx is ''~/.mailrc'', unfortunately also used by the native NetBSD mail(1) client.  If you never plan to use native mail(1) then you can go ahead and put all your settings in ''~/.mailrc'' ; chances are the native mail(1) will just ignore any settings it doesn't understand.  A somewhat better option which maintains settings separation is to create a minimal ''~/.mailrc'' and add the following to it:
+The default user configuration file for S-mailx is ''~/.mailrc'' , unfortunately also used by the native NetBSD mail(1) and Heirloom-mailx clients.  If you never plan to use the other clients then you can go ahead and put all your settings in ''~/.mailrc'' ; chances are the native NetBSD mail(1) will just ignore any settings it doesn't understand; Heirloom-mailx likely will complain more.  A somewhat better option which maintains settings separation is to create a minimal ''~/.mailrc'' and add the following to it:
 <file ~sdfuser/.mailrc>
@@ Line 41: / Line 42: @@
 </file>
-Note that this technique is also used for the Heirloom mailx client via the NAIL_EXTRA_RC variable; having both ''NAIL_EXTRA_RC'' and ''mailx-extra-rc'' set in ''~sdfuser/.mailrc'' will likely produce ignorable but annoying errors when S-mailx is run.
+Note that this technique is also used for the Heirloom mailx client via the NAIL_EXTRA_RC variable; having both ''NAIL_EXTRA_RC'' and ''mailx-extra-rc'' set in ''~sdfuser/.mailrc'' will likely produce ignore-able but annoying errors when S-mailx is run.
 <file config ~/.s-nailrc>
 ## ~sdfuser/.s-nailrc file - use with /usr/pkg/bin/s-nail
+# hold mail in system Inbox (default):
+set hold
 # see s-nail(1) for details:
 set v15-compat=yes
+# set EDITOR if different than default:
+#set EDITOR=vi
 # allow "dot" EOF; reverse 'r'/'R'; print next msg:
 set bsdcompat dot flip autoprint
-# set some additional headers (must separate w/ commas):
+## Mbox settings:
-set customhdr='Organization: SDF Public Access UNIX System,\
+set from='SDF User <sdfuser@sdf.org>'
-               Zodiac-Sign: Scorpio'
+set reply-to='SDF User <sdfuser@sdf.org>'
+# redundant is set in ~/.mailrc:
+set folder=mail
+# '+' prefix => relative to ~/mail/:
+set MBOX=+Save
+set record=+Sent
+shortcut saved +Save
+shortcut sent +Sent
+## automatic MIME type processing:
+# pipe all webified msgs thru lynx(1):
+set pipe-text/html='?* lynx -stdin -dump -force_html'
+## command aliases:
+# use to return from remote accts:
+commandalias home 'account null'
+# match mail(1) cmd:
+commandalias inc 'newmail'
+# quiet the 'set' cmd:
+commandalias set '\ignerr set'
+# thread/unthread cmds:
+commandalias thrd 'sort thread'
+commandalias uthr 'unsort'
+## email address aliases:
+alias snail-list  "S-Mailx List <s-mailx@sdaoden.eu>"
+# group aliases - note: cc/bcc mailings need to have
+#                       at least one To: entry
+#alias hop-list	  hoppy@mud.bog \
+#		  mrwarts@mud.bog \
+#		  "Kermit <froggy@mud.bog>"
+## SMTP stuff:
+# wait until MTA finishes when sending mail.
+# => allows seeing any errors:
+set sendwait
+### IMAP accounts section: ###
+# Another SDF user account:
+account sdfuser2 {
+        set hold
+        # just because..
+        set ssl-verify-mx.sdf.org=ignore
+        set MBOX=+Saved
+        set folder=imaps://sdfuser2@mx.sdf.org/
+        set inbox=imaps://sdfuser2@mx.sdf.org/
+        set password-sdfuser2@mx.sdf.org="********"
+        set from='SDF User2 <sdfuser2@sdf.org>'
+        set record=+Sent
+        shortcut saved +Saved
+        shortcut sent +Sent
+        }
+# Typical Gmail IMAP/SMTP w/ SSL setup (enable IMAP on your acct first);
+# note use of "URL percent encoded" chars in some settings, i.e. '%40' = '@' :
+account gmail {
+        set hold
+        set folder="imaps://gmail.user%40gmail.com@imap.gmail.com/INBOX"
+        set inbox="imaps://gmail.user%40gmail.com@imap.gmail.com/INBOX"
+        set password-gmail.user%40gmail.com@imap.gmail.com='********'
+        set shortcut sent="imaps://gmail.user%40gmail.com@imap.gmail.com/[Gmail]/Sent Mail"
+        set shortcut trash="imaps://gmail.user%40gmail.com@imap.gmail.com/[Gmail]/Trash"
+        set from='Gmail User <gmail.user@gmail.com>'
+        set reply-to='Gmail User <gmail.user@gmail.com>'
+        set record=+Sent
+        shortcut saved +Saved
+        shortcut sent +Sent
+        ### Gmail SMTP stuff ###
+        # => reserved chars in SMTP pwd need to be URL percent encoded <=
+        set mta="smtps://gmail.user%40gmail.com:*********@smtp.gmail.com
+        }
+</file>