[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#42397: [PATCH v2 12/16] * lisp/net/imap.el: Use proper outline headi
From: |
Jonas Bernoulli |
Subject: |
bug#42397: [PATCH v2 12/16] * lisp/net/imap.el: Use proper outline headings |
Date: |
Mon, 10 Aug 2020 23:14:26 +0200 |
This library already used section headings but it used just two
instead of three semicolons, making them indistinguishable from
plain comments. One heading is new.
---
lisp/net/imap.el | 30 ++++++++++++++++++------------
1 file changed, 18 insertions(+), 12 deletions(-)
diff --git a/lisp/net/imap.el b/lisp/net/imap.el
index a492dc8c79..add19c5882 100644
--- a/lisp/net/imap.el
+++ b/lisp/net/imap.el
@@ -134,6 +134,7 @@
;;
;;; Code:
+;;; Dependencies
(eval-when-compile (require 'cl-lib))
(require 'utf7)
@@ -145,7 +146,7 @@
(declare-function digest-md5-digest-uri "ext:digest-md5")
(declare-function digest-md5-challenge "ext:digest-md5")
-;; User variables.
+;;; User variables.
(defgroup imap nil
"Low-level IMAP issues."
@@ -257,7 +258,7 @@ imap-store-password
:group 'imap
:type 'boolean)
-;; Various variables.
+;;; Various variables.
(defvar imap-fetch-data-hook nil
"Hooks called after receiving each FETCH response.")
@@ -316,7 +317,9 @@ imap-logout-timeout
an application program that uses this module specifies on a per-server
basis.")
-;; Internal constants. Change these and die.
+;;; Internal constants
+
+;; Change these and die.
(defconst imap-default-port 143)
(defconst imap-default-ssl-port 993)
@@ -348,7 +351,7 @@ imap-local-variables
(defconst imap-log-buffer "*imap-log*")
(defconst imap-debug-buffer "*imap-debug*")
-;; Internal variables.
+;;; Internal variables.
(defvar imap-stream nil)
(defvar imap-auth nil)
@@ -437,7 +440,7 @@ imap-enable-exchange-bug-workaround
canonical form fails.")
-;; Utility functions:
+;;; Utility functions
(defun imap-remassoc (key alist)
"Delete by side effect any elements of ALIST whose car is `equal' to KEY.
@@ -489,7 +492,8 @@ imap-error-text
(nth 3 (car imap-failed-tags))))
-;; Server functions; stream stuff:
+;;; Server functions
+;;;; Stream functions
(defun imap-log (string-or-buffer)
(when imap-log
@@ -747,7 +751,7 @@ imap-starttls-open
(message "imap: Connecting with STARTTLS...%s" (if done "done" "failed"))
done))
-;; Server functions; authenticator stuff:
+;;;; Authenticator functions
(defun imap-interactive-login (buffer loginfunc)
"Login to server in BUFFER.
@@ -969,7 +973,7 @@ imap-digest-md5-auth
(imap-send-command-1 "")
(imap-ok-p (imap-wait-for-tag tag)))))))
-;; Server functions:
+;;; Server functions
(defun imap-open-1 (buffer)
(with-current-buffer buffer
@@ -1228,7 +1232,7 @@ imap-logout-wait
(imap-send-command-wait "LOGOUT" buffer)))
-;; Mailbox functions:
+;;; Mailbox functions
(defun imap-mailbox-put (propname value &optional mailbox buffer)
(with-current-buffer (or buffer (current-buffer))
@@ -1520,7 +1524,7 @@ imap-mailbox-acl-delete
identifier))))))
-;; Message functions:
+;;; Message functions
(defun imap-current-message (&optional buffer)
(with-current-buffer (or buffer (current-buffer))
@@ -1832,7 +1836,7 @@ imap-envelope-from
(if (aref from 0) ">"))))
-;; Internal functions.
+;;; Internal functions.
(defun imap-add-callback (tag func)
(setq imap-callbacks (append (list (cons tag func)) imap-callbacks)))
@@ -1969,7 +1973,7 @@ imap-arrival-filter
(delete-region (point-min) (point-max)))))))))
-;; Imap parser.
+;;; Imap parser.
(defsubst imap-forward ()
(or (eobp) (forward-char)))
@@ -2850,6 +2854,8 @@ imap-parse-body
(imap-forward)
(nreverse body)))))
+;;; Debug
+
(when imap-debug ; (untrace-all)
(require 'trace)
(buffer-disable-undo (get-buffer-create imap-debug-buffer))
--
2.28.0
- bug#42397: [PATCH v2 07/16] * lisp/progmodes/compile.el: Remove unnecessary comments., (continued)
- bug#42397: [PATCH v2 07/16] * lisp/progmodes/compile.el: Remove unnecessary comments., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 08/16] ; * lisp/whitespace.el: Capitalize "Code" section heading., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 09/16] * lisp/mail/smtpmail.el: Use outline headings., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 11/16] * lisp/obsolete/longlines.el: Use proper outline headings., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 10/16] * test/src/emacs-module-tests.el: Use proper outline headings., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 15/16] ; * lisp/emacs-lisp/autoload.el: Begin summary line with three semicolons., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 16/16] Update section heading conventions for libraries, Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 13/16] * lisp/font-lock.el: Split the Commentary into subsections., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 14/16] * lisp/font-lock.el: No longer use headings as end of section markers., Jonas Bernoulli, 2020/08/10
- bug#42397: [PATCH v2 12/16] * lisp/net/imap.el: Use proper outline headings,
Jonas Bernoulli <=