Remove comments that have migrated to the documentation.

scheme/lib/pop3.scm

@@ -6,78 +6,6 @@
 ;;; For copyright information, see the file COPYING which comes with
 ;;; the distribution.
 
-;;; Overview ==============================================================
-;;
-;; The POP3 protocol allows access to email on a maildrop server. It
-;; is often used in configurations where users connect from a client
-;; machine which doesn't have a permanent network connection or isn't
-;; always turned on, situations which make local SMTP delivery
-;; impossible. It is the most common form of email access provided by
-;; Internet Service Providers.
-;;
-;; Two types of authentication are commonly used. The first, most
-;; basic type involves sending a user's password in clear over the
-;; network, and should be avoided. Unfortunately many POP3 clients
-;; only implement this basic authentication. The digest authentication
-;; system involves the server sending the client a "challenge" token;
-;; the client encodes this token with the pass phrase and sends the
-;; coded information to the server. This method avoids sending
-;; sensitive information over the network.
-;;
-;; Once connected, a client may request information about the number
-;; and size of the messages waiting on the server, download selected
-;; messages (either their headers or the entire content), and delete
-;; selected messages.
-
-
-;;; Entry points =======================================================
-;;
-;; (pop3-connect [host logfile]) -> connection
-;;    Connect to the maildrop server named HOST. Optionally log the
-;;    conversation with the server to LOGFILE, which will be appended
-;;    to if it exists, and created otherwise. The environment variable
-;;    MAILHOST, if set, will override the value of HOST.
-;;
-;; (pop3-login connection [login password]) -> status
-;;    Log in to the mailhost. If a login and password are not
-;;    provided, they are first searched for in the user's ~/.netrc
-;;    file. USER/PASS authentication will be tried first, and if this
-;;    fails, APOP authentication will be tried.
-;;
-;; (pop3-login/APOP connection login password) -> status
-;;    Log in to the mailhost using APOP authentication.
-;;
-;; (pop3-stat connection) -> integer x integer
-;;    Return the number of messages and the number of bytes waiting in
-;;    the maildrop.
-;;
-;; (pop3-get connection msgid) -> status
-;;    Download message number MSGID from the mailhost. MSGID must be
-;;    positive and less than the number of messages returned by the
-;;    pop3-stat call. The message contents are sent to
-;;    (current-output-port).
-;;
-;; (pop3-headers connection msgid) -> status
-;;    Download the headers of message number MSGID. The data is sent
-;;    to (current-output-port).
-;;
-;; (pop3-last connection) -> integer
-;;    Return the highest accessed message-id number for the current
-;;    session. This isn't in the RFC, but seems to be supported by
-;;    several servers.
-;;
-;; (pop3-delete connection msgid) -> status
-;;    Mark message number MSGID for deletion. The message will not be
-;;    deleted until the client logs out.
-;;
-;; (pop3-reset connection) -> status
-;;    Any messages which have been marked for deletion are unmarked.
-;;
-;; (pop3-quit connection) -> status
-;;    Close the connection with the mailhost.
-
-
-
 ;;; Related work =====================================================
 ;;
 ;; * Emacs is distributed with a C program called movemail which can
@@ -92,9 +20,7 @@
 ;;   includes support for the POP3 protocol.
 ;;
 ;; * rfc1939 describes the POP3 protocol.
-
+;;   http://www.ietf.org/rfc/rfc1939.txt
-
-
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;; Communication is initiated by the client. The server responds to