From mboxrd@z Thu Jan  1 00:00:00 1970
X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/32513
Path: main.gmane.org!not-for-mail
From: Simon Josefsson <simon@josefsson.org>
Newsgroups: gmane.emacs.gnus.general
Subject: Re: doc bug?  IMAP info misleading
Date: 20 Sep 2000 12:45:49 +0200
Sender: owner-ding@hpc.uh.edu
Message-ID: <iluog1j9w9u.fsf@barbar.josefsson.org>
References: <vafg0mvienm.fsf@lucy.cs.uni-dortmund.de>
NNTP-Posting-Host: coloc-standby.netfonds.no
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
X-Trace: main.gmane.org 1035168788 20266 80.91.224.250 (21 Oct 2002 02:53:08 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Mon, 21 Oct 2002 02:53:08 +0000 (UTC)
Cc: ding@gnus.org
Return-Path: <owner-ding@hpc.uh.edu>
Original-Received: from fisher.math.uh.edu (fisher.math.uh.edu [129.7.128.35])
	by mailhost.sclp.com (Postfix) with ESMTP id 50437D051E
	for <jason@mailhost.sclp.com>; Wed, 20 Sep 2000 11:39:12 -0400 (EDT)
Original-Received: from sina.hpc.uh.edu (lists@Sina.HPC.UH.EDU [129.7.3.5])
	by fisher.math.uh.edu (8.9.1/8.9.1) with ESMTP id FAC27011;
	Wed, 20 Sep 2000 05:46:00 -0500 (CDT)
Original-Received: by sina.hpc.uh.edu (TLB v0.09a (1.20 tibbs 1996/10/09 22:03:07)); Wed, 20 Sep 2000 05:45:21 -0500 (CDT)
Original-Received: from mailhost.sclp.com (postfix@66-209.196.61.interliant.com [209.196.61.66] (may be forged))
	by sina.hpc.uh.edu (8.9.3/8.9.3) with ESMTP id FAA17011
	for <ding@hpc.uh.edu>; Wed, 20 Sep 2000 05:45:10 -0500 (CDT)
Original-Received: from vic20.blipp.com (unknown [195.163.165.35])
	by mailhost.sclp.com (Postfix) with ESMTP id 36A2CD051E
	for <ding@gnus.org>; Wed, 20 Sep 2000 06:45:32 -0400 (EDT)
Original-Received: from barbar.josefsson.org (localhost [127.0.0.1])
	by vic20.blipp.com (8.10.1/8.10.1) with ESMTP id e8KAjNS18631;
	Wed, 20 Sep 2000 12:45:25 +0200
Original-To: Kai.Grossjohann@CS.Uni-Dortmund.DE (Kai =?iso-8859-1?q?Gro=DFjohann?=)
In-Reply-To: <vafg0mvienm.fsf@lucy.cs.uni-dortmund.de>
Mail-Copies-To: nobody
Original-Lines: 56
User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7
Precedence: list
X-Majordomo: 1.94.jlt7
Xref: main.gmane.org gmane.emacs.gnus.general:32513
X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:32513

Kai.Grossjohann@CS.Uni-Dortmund.DE (Kai Großjohann) writes:

> I think the Gnus info file is misleading wrt IMAP setup, but I'm not
> sure what to do about it.

I agree.  Examples rules.  Is this better?  I've commited it.

IMAP
----

   IMAP is a network protocol for reading mail (or news, or ...), think
of it as a modernized NNTP.  Connecting to a IMAP server is much
similar to connecting to a news server, you just specify the network
address of the server.

   The following variables can be used to create a virtual `nnimap'
server:

...

`nnimap-server-port'
     Port on server to contact.  Defaults to port 143, or 993 for SSL.

     Note that this should be a integer, example server specification:

          (nnimap "mail.server.com"
                  (nnimap-server-port 4711))

...

`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).

     Example server specification:

          (nnimap "mail.server.com"
                  (nnimap-stream ssl))

     Please note that the value of `nnimap-stream' is a symbol!

        * "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').
...