Commentary update

pew/lisp/elpa-completion-corfu.el

@@ -1,6 +1,8 @@
 ;;; elpa-completion-corfu.el --- corfu and complementary -*- lexical-binding: t; -*-
 ;;; Commentary:
-;; Minimalistic completion framework
+
+;; Minimalistic completion framework.
+
 ;;; Code:
 
 ;;; Package: corfu -- Completion frontend

pew/lisp/elpa-completion-ivy.el

@@ -1,9 +1,12 @@
 ;;; elpa-completion-ivy.el --- ivy and complementary -*- lexical-binding: t; -*-
 ;;; Commentary:
-;;; Code:
 
-;;; Package: counsel -- Contains ivy, counsel and swipper
+;; NOTE: The `counsel' contains ivy, counsel and swipper.
 ;; See: https://oremacs.com/swiper/#installing-from-emacs-package-manager
+
+;;; Code:
+
+;;; Package: counsel
 (pewcfg::use-package counsel
   :demand t
   :bind (("C-s" . swiper)

pew/lisp/elpa-completion-vertico.el

@@ -1,9 +1,11 @@
 ;;; elpa-completion-vertico.el --- vertico and complementary -*- lexical-binding: t; -*-
 ;;; Commentary:
+
+;; Recommended package bundles are from: https://github.com/minad/vertico#complementary-packages
+
 ;;; Code:
 
 ;;; Package: vertico
-;; Package bundle recommended in: https://github.com/minad/vertico#complementary-packages
 (pewcfg::use-package vertico
   :demand t
   :bind (:map vertico-map

pew/lisp/elpa-evil.el

@@ -1,9 +1,17 @@
 ;;; elpa-evil.el --- evil and complementary -*- lexical-binding: t; -*-
 ;;; Commentary:
 
-;; NOTE: There is a bug while configuring with `use-package', which causes
-;; certain variables not being set.  To make a temporary workaround, enable
-;; `use-package' in `enable-theme' and then invoke `custom-theme-save'.
+;; NOTE: There is a bug where certain custom settings from `use-package' is
+;; not effective.
+;;
+;; One way is to add `use-package' into the `custom-enabled-themes' list and
+;; make it persistent across sessions, but it may be accidentally disabled.
+;;
+;; The other way is to add following code at the end of startup.
+;;
+;; (let ((theme 'use-package))
+;;   (enable-theme theme)
+;;   (setq custom-enabled-themes (remq theme custom-enabled-themes)))
 
 ;;; Code:
 

pew/lisp/init-boot.el

@@ -1,6 +1,8 @@
 ;;; init-boot.el --- early initialization -*- lexical-binding: t; -*-
 ;;; Commentary:
+
 ;; This file should be required at the beginning of the entire initialization.
+
 ;;; Code:
 
 ;;; Performance optimization

pew/lisp/init-common.el

@@ -1,6 +1,8 @@
 ;;; init-common.el --- common library -*- lexical-binding: t; -*-
 ;;; Commentary:
+
 ;; This file should be loaded as early as possible.
+
 ;;; Code:
 
 ;;; Buffer definitions

pew/lisp/init-defaults.el

@@ -1,6 +1,8 @@
 ;;; init-defaults.el --- built-in config -*- lexical-binding: t; -*-
 ;;; Commentary:
+
 ;; Set Emacs built-ins with my own flavor.
+
 ;;; Code:
 
 (pewcfg

pew/lisp/init-package.el

@@ -1,6 +1,8 @@
 ;;; init-package.el --- package management -*- lexical-binding: t; -*-
 ;;; Commentary:
+
 ;; This ELPA initialization configuration should be loaded as early as possible.
+
 ;;; Code:
 
 ;;; Builtin package manager

pew/site-lisp/long-log-mode.el

@@ -1,9 +1,13 @@
 ;;; long-log-mode.el --- Long log mode -*- lexical-binding: t; -*-
 
+;; Author:  Fang Deng <[email protected]>
+
 ;;; Commentary:
+
 ;; This major mode is based on `so-long-mode' with some additional tweaks.
 
 ;;; Code:
+
 (require 'so-long)
 
 (define-derived-mode long-log-mode so-long-mode "LongLog"

pew/site-lisp/symlink-manager-mode.el

@@ -1,10 +1,14 @@
 ;;; symlink-manager-mode.el --- Symlink Manager Mode -*- lexical-binding: t; -*-
 
+;; Author:  Fang Deng <[email protected]>
+
 ;;; Commentary:
+
 ;; The major mode that creates/deletes symlinks defined in the current buffer
 ;; content.
 
 ;;; Code:
+
 (defun sm-create-link (target ask)
   "Create a link of TARGET to the current directory.
 If ASK is a non-nil the link will be force overridden or prompted for