From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.user/2737 Path: news.gmane.org!not-for-mail From: Sebastian Kaps Newsgroups: gmane.emacs.gnus.user Subject: Re: Setting up Gnus with IMAP Date: Mon, 14 Jul 2003 15:29:18 +0200 Organization: a private linux site Message-ID: References: <843ch9plcz.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: 8bit X-Trace: sea.gmane.org 1138669062 16161 80.91.229.2 (31 Jan 2006 00:57:42 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 31 Jan 2006 00:57:42 +0000 (UTC) Original-X-From: nobody Tue Jan 17 17:31:09 2006 Original-Newsgroups: gnu.emacs.gnus Original-NNTP-Posting-Host: toyland.sauerland.de Original-X-Trace: klendathu.sauerland.de 1058189358 15767 192.168.1.1 (14 Jul 2003 13:29:18 GMT) Original-X-Complaints-To: seb@sauerland.de Original-NNTP-Posting-Date: 14 Jul 2003 13:29:18 GMT X-Now-Playing: Belphegor - Tanzwut =?iso-8859-1?q?Totenges=E4nge?= User-Agent: Gnus/5.090018 (Oort Gnus v0.18) XEmacs/21.5 (burdock, linux) Cancel-Lock: sha1:zPNBe4RmBrFzmt03zyCITeJV64Y= Original-Path: quimby.gnus.org!newsfeed.gazeta.pl!newsfeed.tpinternet.pl!newsfeed01.sul.t-online.de!t-online.de!news.belwue.de!news.ipv6.iphh.net!iphh.net!news.ecore.net!lilly.ping.de!news.prima.de!gomorrah.sauerland.de!klendathu.sauerland.de!not-for-mail Original-Xref: bridgekeeper.physik.uni-ulm.de gnus-emacs-gnus:2877 Original-Lines: 75 X-Gnus-Article-Number: 2877 Tue Jan 17 17:31:09 2006 Xref: news.gmane.org gmane.emacs.gnus.user:2737 Archived-At: // Simon Josefsson writes: > Sebastian Kaps writes: >> // Kai Großjohann writes: >> >>> IMHO it doesn't make sense to specify so many values which are the >>> default anyhow. For example, should the port be "143" or 143? >>> Should the authenticator be "login" or login? Etc pp. >> >> Yes, you're right. But shouldn't the documentation be more clearly about >> this issue? > The documentation says the following. How can we improve it? My version of the documentation seems a bit outdated. For nnimap-stream it says: ,---- | `nnimap-stream' | The type of stream used to connect to your server. By default, | nnimap will detect and automatically use all of the below, with | the exception of SSL. (SSL is being replaced by STARTTLS, which | can be automatically detected, but it's not widely deployed yet). | | * "gssapi:" Connect with GSSAPI (usually kerberos 5). Require | the `imtest' program. | | * "kerberos4:" Connect with kerberos 4. Require the `imtest' | program. | | * "starttls:" Connect via the STARTTLS extension (similar to | SSL). Require the external library `starttls.el' and program | `starttls'. | | * "ssl:" Connect through SSL. Require OpenSSL (the program | `openssl') or SSLeay (`s_client'). | | * "network:" Plain, TCP/IP network connection. | | The `imtest' program is shipped with Cyrus IMAPD, nnimap support | both `imtest' version 1.5.x and version 1.6.x. | | For SSL connections, the OpenSSL program is available from | `http://www.openssl.org/'. OpenSSL was formerly known as SSLeay, | and nnimap support it too - altough the most recent versions of | SSLeay, 0.9.x, are known to have serious bugs making it useless. | Earlier versions, especially 0.8.x, of SSLeay are known to work. `---- Note that the possible values are quoted (and even contain colons). This might be confusing. > `nnimap-stream' > The type of stream used to connect to your server. By default, > nnimap will detect and automatically use all of the below, with > the exception of TLS/SSL. (IMAP over TLS/SSL is being replaced by > STARTTLS, which can be automatically detected, but it's not widely > deployed yet.) > Example server specification: > (nnimap "mail.server.com" > (nnimap-stream ssl)) > Please note that the value of `nnimap-stream' is a symbol! > ... This is much better. I think the example wipes out any possible doubt. However - as an end user who is not very familar with lisp - the "...is a symbol!" part doesn't help much. I'd have to look up the meaning of 'symbol' in the lisp documentation, which wouldn't be a problem but I think it's unnecessary. -- Ciao, Sebastian