From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: kai.grossjohann@uni-duisburg.de (Kai =?iso-8859-1?q?Gro=DFjohann?=) Newsgroups: gmane.emacs.devel Subject: Re: Emacs Manual: Mail sending via SMTP Date: Sat, 22 Feb 2003 11:33:07 +0100 Organization: University of Duisburg, Germany Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <84wujsd2qk.fsf@lucy.is.informatik.uni-duisburg.de> References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1045910148 9476 80.91.224.249 (22 Feb 2003 10:35:48 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 22 Feb 2003 10:35:48 +0000 (UTC) Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18mX0V-0002Se-00 for ; Sat, 22 Feb 2003 11:35:47 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18mXEw-0000Vt-00 for ; Sat, 22 Feb 2003 11:50:42 +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 18mWzd-0005pA-06 for emacs-devel@quimby.gnus.org; Sat, 22 Feb 2003 05:34:53 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18mWzM-0005ob-00 for emacs-devel@gnu.org; Sat, 22 Feb 2003 05:34:36 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18mWyq-0005eT-00 for emacs-devel@gnu.org; Sat, 22 Feb 2003 05:34:35 -0500 Original-Received: from main.gmane.org ([80.91.224.249]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18mWyq-0005eA-00 for emacs-devel@gnu.org; Sat, 22 Feb 2003 05:34:04 -0500 Original-Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 18mWyh-0002Ms-00 for ; Sat, 22 Feb 2003 11:33:55 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-To: emacs-devel@gnu.org Original-Received: from news by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 18mWyh-0002Mj-00 for ; Sat, 22 Feb 2003 11:33:55 +0100 Original-Lines: 37 Original-X-Complaints-To: usenet@main.gmane.org User-Agent: Gnus/5.090016 (Oort Gnus v0.16) Emacs/21.3.50 Cancel-Lock: sha1:N39HRIHheTN2F9SC21Sj81HqDHQ= 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:11841 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:11841 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 should be > described for each mail user agent; for the Message and Gnus user > agents the variable `message-send-mail-function' (see *note Mail Variables: (message)Mail Variables.) > is used. > > The variable `send-mail-function' controls how the default mail user > 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. 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. 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). -- A preposition is not a good thing to end a sentence with.