From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Simon Josefsson Newsgroups: gmane.emacs.devel Subject: Re: Emacs Manual: Mail sending via SMTP Date: Sun, 23 Feb 2003 13:17:34 +0100 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <84wujsd2qk.fsf@lucy.is.informatik.uni-duisburg.de> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: main.gmane.org 1046002722 16017 80.91.224.249 (23 Feb 2003 12:18:42 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sun, 23 Feb 2003 12:18:42 +0000 (UTC) Cc: emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18mv5a-00049l-00 for ; Sun, 23 Feb 2003 13:18:38 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18mvKX-0007rI-00 for ; Sun, 23 Feb 2003 13:34:05 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18mv50-0002W3-00 for emacs-devel@quimby.gnus.org; Sun, 23 Feb 2003 07:18:02 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18mv4i-0002VX-00 for emacs-devel@gnu.org; Sun, 23 Feb 2003 07:17:44 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18mv4g-0002Un-00 for emacs-devel@gnu.org; Sun, 23 Feb 2003 07:17:43 -0500 Original-Received: from 178.230.13.217.in-addr.dgcsystems.net ([217.13.230.178] helo=yxa.extundo.com) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18mv4e-0002T0-00 for emacs-devel@gnu.org; Sun, 23 Feb 2003 07:17:41 -0500 Original-Received: from latte.josefsson.org (yxa.extundo.com [217.13.230.178]) (authenticated bits=0) by yxa.extundo.com (8.12.7/8.12.7) with ESMTP id h1NCHYXf005863 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=OK); Sun, 23 Feb 2003 13:17:35 +0100 Original-To: kai.grossjohann@uni-duisburg.de (Kai =?iso-8859-1?q?Gro=DFjohann?=) Mail-Copies-To: nobody X-Payment: hashcash 1.1 0:030223:kai.grossjohann@uni-duisburg.de:b84746d5a45af16b X-Hashcash: 0:030223:kai.grossjohann@uni-duisburg.de:b84746d5a45af16b X-Payment: hashcash 1.1 0:030223:emacs-devel@gnu.org:d5f1c3a0594a3d37 X-Hashcash: 0:030223:emacs-devel@gnu.org:d5f1c3a0594a3d37 In-Reply-To: <84wujsd2qk.fsf@lucy.is.informatik.uni-duisburg.de> (kai.grossjohann@uni-duisburg.de's message of "Sat, 22 Feb 2003 11:33:07 +0100") User-Agent: Gnus/5.090016 (Oort Gnus v0.16) Emacs/21.3.50 X-MIME-Autoconverted: from 8bit to quoted-printable by yxa.extundo.com id h1NCHYXf005863 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:11876 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:11876 kai.grossjohann@uni-duisburg.de (Kai Gro=DFjohann) writes: > Simon Josefsson writes: > >> Sending mail via SMTP requires configuring your mail user agent >> (see *note Mail Methods::) to use the SMTP library. How to do this sh= ould be >> described for each mail user agent; for the Message and Gnus user >> agents the variable `message-send-mail-function' (see *note Mail Varia= bles: (message)Mail Variables.) >> is used. >> >> The variable `send-mail-function' controls how the default mail use= r >> agent sends mail. It should be set to a function. The default is >> `sendmail-send-it', but must be set to `smtpmail-send-it' in order to >> use the SMTP library. `feedmail-send-it' is another option. > > How about putting some example code there? Something like this: > > If you use RMAIL, the first line will enable the SMTP library; if > you use Gnus, the second will do: > > (setq send-mail-function 'smtpmail-send-it) > (setq message-send-mail-function 'smtpmail-send-it) > > That way, people can copy and paste easily. Good idea, added. Also, it was suggested to split out the SMTP section into a separate file, so I have done that. I made some other changes too. > Also, I wonder if it would be useful to give it a little bit more > structure, visually? For example, you could talk about the concepts > in normal paragraphs, but then use a description list for explaining > each variable. Also, maybe it would be useful to have a subheading > for the part that talks about authentication. That would make it > easier for people to find it. Yup. Done. > And finally, I'm not sure about the policy regarding `esoteric' > variables. It's possible that these should normally be documented in > the manual. Then the description list format would be ideal for > doing that (possibly under an "esoteric variables" heading). Since it is now a standalone manual, I think everything that we can say about the library is appropriate.