Add comments to plain configs

home-manager/software/emacs/emacs.d/lib/loader.el

@@ -1,5 +1,4 @@
 ;; My details
-
 (setq user-full-name "Andreas Zweili")
 (setq user-mail-address "andreas@zweili.ch")
 
@@ -8,12 +7,14 @@
 (setq-default tab-width 4)
 (setq indent-line-function 'insert-tab)
 
-;; enable hippie expand on M-Space
+;; Enable hippie expand on M-Space. It helps with path completion and more
 (global-set-key "\M- " 'hippie-expand)
 
 ;; file encodings
 (prefer-coding-system 'utf-8-unix)
 
+;; Save temp files in the OS temp directory. Otherwise they clutter up the
+;; current working directory
 (setq backup-directory-alist
       `((".*" . ,temporary-file-directory)))
 (setq auto-save-file-name-transforms
@@ -25,18 +26,24 @@
 ;; insert only one space after a period
 (setq sentence-end-double-space nil)
 
+;; Enable line wrapping
 (add-hook 'text-mode-hook 'turn-on-auto-fill)
+;; line length
+(setq-default fill-column 79)
 
+;; Supress "ad-handle-definition: `tramp-read-passwd' got redefined" message at
+;; start.
 (setq ad-redefinition-action 'accept)
 
+;; Remove whitespace when saving
 (add-hook 'before-save-hook 'whitespace-cleanup)
 
+;; Refresh buffers if the file changes on disk
 (global-auto-revert-mode t)
 
-(setq-default fill-column 79)
-
 (setq history-delete-duplicates t)
 
+;; enable mouse support in the terminal
 (xterm-mouse-mode 1)
 
 (add-hook 'text-mode-hook (lambda () (electric-indent-local-mode -1)))
@@ -45,4 +52,5 @@
           (lambda ()
             (setq pcomplete-cycle-completions nil)))
 
+;; For better performance use "ssh" instead of "scp"
 (setq tramp-default-method "ssh")