Change header/footer comment of all files to make elisp happy

core/siren-core.el

@@ -1,7 +1,11 @@
-;;
-;; core stuff - again shamelessly ripped from Emacs Prelude
-;;
+;;; siren-core.el --- jimeh's Emacs Siren: Core Siren functions.
 
+;;; Commentary:
+
+;; Core Siren functions used a bit all over the place. Some of them shamelessly
+;; ripped from Emacs Prelude.
+
+;;; Code:
 
 (defun siren-smart-open-line-above ()
   "Insert an empty line above the current line.
@@ -20,3 +24,4 @@ Position the cursor at it's beginning, according to the current mode."
 
 
 (provide 'siren-core)
+;;; siren-core.el ends here

core/siren-custom.el

@@ -1,6 +1,12 @@
+;;; siren-custom.el --- jimeh's Emacs Siren: Siren's customizable variables.
+
+;;; Commentary:
+
+;; Refinements of the core editing experience in Emacs.
 ;;
-;; siren custom
-;;
+;; Shamelessly ripped from Emacs Prelude.
+
+;;; Code:
 
 (defcustom siren-yank-indent-threshold 1000
   "Threshold (# chars) over which indentation does not automatically occur."
@@ -20,4 +26,5 @@ Only modes that don't derive from `prog-mode' should be listed here."
   :group 'siren)
 
 
-(provide 'siren-custom)
+(provide 'siren-custom)
+;;; siren-custom.el ends here

core/siren-editor.el

@@ -1,6 +1,10 @@
-;;
-;; editor
-;;
+;;; siren-core.el --- jimeh's Emacs Siren: Editor settings.
+
+;;; Commentary:
+
+;; Default editor settings for Siren.
+
+;;; Code:
 
 ;; Set default font
 (if window-system
@@ -202,6 +206,5 @@ indent yanked text (with prefix arg don't indent)."
 ;; (diminish 'hs-minor-mode)
 ;; (diminish 'subword-mode)
 
-
-
 (provide 'siren-editor)
+;;; siren-editor.el ends here

core/siren-env.el

@@ -1,6 +1,11 @@
-;;
-;; env
-;;
+;;; siren-env.el --- jimeh's Emacs Siren: Environment variable setup.
+
+;;; Commentary:
+
+;; Setup for various environment variables to ensure external programs are
+;; available.
+
+;;; Code:
 
 ;; Nix package manager
 (push "~/.nix-profile/bin" exec-path)
@@ -20,3 +25,4 @@
 
 
 (provide 'siren-env)
+;;; siren-env.el ends here

core/siren-osx.el

@@ -1,6 +1,10 @@
-;;
-;; osx
-;;
+;;; siren-osx.el --- jimeh's Emacs Siren: OS X specific settings.
+
+;;; Commentary:
+
+;; OS X specific settings and tweaks for Siren.
+
+;;; Code:
 
 ;; It's all in the Meta
 (setq ns-function-modifier 'hyper)
@@ -8,5 +12,5 @@
 ;; Don't use OSX Native fullscreen mode
 (setq ns-use-native-fullscreen nil)
 
-
-(provide 'siren-osx)
+(provide 'siren-osx)
+;;; siren-osx.el ends here

core/siren-packages.el

@@ -1,6 +1,10 @@
-;;
-;; packages
-;;
+;;; siren-packages.el --- jimeh's Emacs Siren: Core package setup
+
+;;; Commentary:
+
+;; Install and configure various packages that the core of Siren depends on.
+
+;;; Code:
 
 (require 'cl)
 (require 'package)
@@ -66,5 +70,5 @@ Missing packages are installed automatically."
 ;; Install Melpa packages
 (siren-install-packages)
 
-
 (provide 'siren-packages)
+;;; siren-packages.el ends here

core/siren-ui.el

@@ -1,6 +1,10 @@
-;;
-;; ui
-;;
+;;; siren-ui.el --- jimeh's Emacs Siren: Emacs UI settings.
+
+;;; Commentary:
+
+;; Basic configuration of Emacs UI for Siren.
+
+;;; Code:
 
 ;; the toolbar is just a waste of valuable screen estate
 ;; in a tty tool-bar-mode does not properly auto-load, and is
@@ -48,5 +52,5 @@
 (setq sml/theme nil)
 (add-hook 'after-init-hook #'sml/setup)
 
-
 (provide 'siren-ui)
+;;; siren-ui.el ends here

init.el

@@ -1,8 +1,10 @@
-;;
-;; Emacs Configuration
-;;
+;;; init.el --- jimeh's Emacs Siren: init file.
 
-;; Set root directory of Emacs config
+;;; Commentary:
+
+;; The file that starts it all.
+
+;;; Code:
 
 ;; I need to keep this here commented out like this to prevent package.el from
 ;; automatically adding it again. I call `(package-initalize)' manually from
@@ -83,3 +85,5 @@
 ;; the theme
 (if (file-exists-p siren-theme-file)
   (load siren-theme-file))
+
+;;; init.el ends here

modules/siren-aliases.el

@@ -1,6 +1,10 @@
-;;
-;; Setup a few global command aliases
-;;
+;;; siren-aliases.el --- jimeh's Emacs Siren: Common aliases
+
+;;; Commentary:
+
+;; Common aliases I use all the time.
+
+;;; Code:
 
 ;; Text Manipulation
 (defalias 'rs 'replace-string)
@@ -31,5 +35,5 @@
 ;; Modes
 (defalias 'sh 'shell-script-mode)
 
-
-(provide 'siren-aliases)
+(provide 'siren-aliases)
+;;; siren-aliases.el ends here

modules/siren-auto-complete.el

@@ -1,6 +1,10 @@
-;;
-;; auto-complete
-;;
+;;; siren-auto-complete.el --- jimeh's Emacs Siren: auto-complete configuration.
+
+;;; Commentary:
+
+;; Basic configuration for auto-complete.
+
+;;; Code:
 
 (siren-require-packages '(auto-complete))
 
@@ -23,10 +27,10 @@
 
 ;; Auto-complete when indenting.
 (defadvice indent-for-tab-command (around ac-before-indent activate)
-  "Call `auto-complete' if text was recently entered"
+  "Call `auto-complete' if text was recently entered."
   (if (ac-trigger-command-p last-command)
       (auto-complete)
     ad-do-it))
 
-
 (provide 'siren-auto-complete)
+;;; siren-auto-complete.el ends here

modules/siren-avy.el

@@ -1,6 +1,11 @@
-;;
-;; avy allows us to effectively navigate to visible things
-;;
+;;; siren-avy.el --- jimeh's Emacs Siren: avy configuration.
+
+;;; Commentary:
+
+;; Basic configuration for avy. Avy allows us to effectively navigate to visible
+;; things.
+
+;;; Code:
 
 (siren-require-packages '(ace-window avy))
 
@@ -14,5 +19,5 @@
 (define-key global-map (kbd "C-c SPC") 'avy-goto-char)
 (define-key global-map (kbd "M-o") 'ace-window)
 
-
-(provide 'siren-avy)
+(provide 'siren-avy)
+;;; siren-avy.el ends here

modules/siren-coffee.el

@@ -1,6 +1,10 @@
-;;
-;; coffeescript
-;;
+;;; siren-coffee.el --- jimeh's Emacs Siren: coffee-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for coffee-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -32,5 +36,5 @@
      (add-hook 'coffee-mode-hook (lambda ()
                                    (run-hooks 'siren-coffee-mode-hook)))))
 
-
 (provide 'siren-coffee)
+;;; siren-coffee.el ends here

modules/siren-company.el

@@ -1,6 +1,10 @@
-;;
-;; company
-;;
+;;; siren-company.el --- jimeh's Emacs Siren: company configuration.
+
+;;; Commentary:
+
+;; Basic configuration for company. Auto completion on steroids.
+
+;;; Code:
 
 (siren-require-packages '(company))
 
@@ -39,5 +43,5 @@
   (let ((completion-at-point-functions completion-at-point-functions-saved))
     (company-complete-common)))
 
-
 (provide 'siren-company)
+;;; siren-company.el ends here

modules/siren-css.el

@@ -1,6 +1,10 @@
-;;
-;; css
-;;
+;;; siren-css.el --- jimeh's Emacs Siren: css-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for css-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -23,5 +27,5 @@
      (add-hook 'css-mode-hook (lambda ()
                                 (run-hooks 'siren-css-mode-hook)))))
 
-
 (provide 'siren-css)
+;;; siren-css.el ends here

modules/siren-cucumber.el

@@ -1,6 +1,10 @@
-;;
-;; feature
-;;
+;;; siren-cucumber.el --- jimeh's Emacs Siren: feature-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for feature-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -18,5 +22,5 @@
 (add-hook 'feature-mode-hook (lambda ()
                                (run-hooks 'siren-feature-mode-hook)))
 
-
 (provide 'siren-cucumber)
+;;; siren-cucumber.el ends here

modules/siren-dired.el

@@ -1,6 +1,10 @@
-;;
-;; dired
-;;
+;;; siren-dired.el --- jimeh's Emacs Siren: dired configuration.
+
+;;; Commentary:
+
+;; Basic configuration for dired.
+
+;;; Code:
 
 (siren-require-packages '(dired+))
 (require 'dired+)
@@ -15,5 +19,5 @@
 (add-hook 'dired-mode-hook (lambda ()
                              (run-hooks 'siren-dired-mode-hook)))
 
-
 (provide 'siren-dired)
+;;; siren-dired.el ends here

modules/siren-ecb.el

@@ -1,6 +1,10 @@
-;;
-;; ecb
-;;
+;;; siren-ecb.el --- jimeh's Emacs Siren: ECB configuration.
+
+;;; Commentary:
+
+;; Basic configuration for ECB.
+
+;;; Code:
 
 (siren-require-packages '(ecb))
 
@@ -28,5 +32,5 @@
 
 (if window-system (ecb-activate))
 
-
 (provide 'siren-ecb)
+;;; siren-ecb.el ends here

modules/siren-elscreen.el

@@ -1,6 +1,10 @@
-;;
-;; elscreen
-;;
+;;; siren-elscreen.el --- jimeh's Emacs Siren: elscreen configuration.
+
+;;; Commentary:
+
+;; Basic configuration for elscreen.
+
+;;; Code:
 
 (siren-require-packages '(elscreen elscreen-buffer-group))
 
@@ -28,9 +32,8 @@
 (define-key elscreen-map (kbd ";")   'elscreen-display-screen-name-list)
 (define-key elscreen-map (kbd "C-;") 'elscreen-display-screen-name-list)
 
-
 ;; Start ElScreen.
 (elscreen-start)
 
-
 (provide 'siren-elscreen)
+;;; siren-elscreen.el ends here

modules/siren-emacs-lisp.el

@@ -1,6 +1,10 @@
-;;
-;; emacs-lisp
-;;
+;;; siren-emacs-lisp.el --- jimeh's Emacs Siren: emacs-lisp-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for emacs-lisp-mode.
+
+;;; Code:
 
 (siren-require-packages '(rainbow-mode))
 
@@ -43,5 +47,5 @@
 (eval-after-load "rainbow-mode"
   '(diminish 'rainbow-mode))
 
-
 (provide 'siren-emacs-lisp)
+;;; siren-emacs-lisp.el ends here

modules/siren-escreen.el

@@ -1,6 +1,10 @@
-;;
-;; escreen
-;;
+;;; siren-escreen.el --- jimeh's Emacs Siren: escreen configuration.
+
+;;; Commentary:
+
+;; Basic configuration for escreen.
+
+;;; Code:
 
 ;; Loads from vendor.
 (require 'escreen)
@@ -64,5 +68,5 @@
 (add-hook 'escreen-goto-screen-hook
           'escreen-get-active-screen-numbers-with-emphasis)
 
-
 (provide 'siren-escreen)
+;;; siren-escreen.el ends here

modules/siren-exec-path-from-shell.el

@@ -1,6 +1,10 @@
-;;
-;; exec-path-from-shell
-;;
+;;; siren-exec-path-from-shell.el --- jimeh's Emacs Siren: exec-path-from-shell configuration.
+
+;;; Commentary:
+
+;; Basic configuration for exec-path-from-shell.
+
+;;; Code:
 
 (siren-require-packages '(exec-path-from-shell))
 
@@ -9,3 +13,4 @@
     (exec-path-from-shell-initialize))
 
 (provide 'siren-exec-path-from-shell)
+;;; siren-exec-path-from-shell.el ends here

modules/siren-fci.el

@@ -1,6 +1,10 @@
-;;
-;; fci
-;;
+;;; siren-fci.el --- jimeh's Emacs Siren: fill-column-indicator configuration.
+
+;;; Commentary:
+
+;; Basic configuration for fill-column-indicator.
+
+;;; Code:
 
 (siren-require-packages '(fill-column-indicator))
 
@@ -8,5 +12,5 @@
 (setq fci-rule-width 1
       fci-handle-trucate-lines nil)
 
-
-(provide 'siren-fci)
+(provide 'siren-fci)
+;;; siren-fci.el ends here

modules/siren-flycheck.el

@@ -1,6 +1,10 @@
-;;
-;; flycheck
-;;
+;;; siren-flycheck.el --- jimeh's Emacs Siren: flycheck configuration.
+
+;;; Commentary:
+
+;; Basic configuration for flycheck.
+
+;;; Code:
 
 (siren-require-packages '(flycheck))
 
@@ -9,5 +13,5 @@
 (setq flycheck-idle-change-delay 1.0)
 (setq flycheck-indication-mode 'right-fringe)
 
-
 (provide 'siren-flycheck)
+;;; siren-flycheck.el ends here

modules/siren-full-ack.el

@@ -1,6 +1,10 @@
-;;
-;; full-ack
-;;
+;;; siren-full-ack.el --- jimeh's Emacs Siren: full-ack configuration.
+
+;;; Commentary:
+
+;; Basic configuration for full-ack.
+
+;;; Code:
 
 (siren-require-packages '(full-ack))
 
@@ -36,3 +40,4 @@
 
 
 (provide 'siren-full-ack)
+;;; siren-full-ack.el ends here

modules/siren-github.el

@@ -1,10 +1,14 @@
-;;
-;; github
-;;
+;;; siren-github.el --- jimeh's Emacs Siren: Github related stuff.
+
+;;; Commentary:
+
+;; Basic configuration for various Github related packages.
+
+;;; Code:
 
 (siren-require-packages '(github-browse-file))
 
 (require 'github-browse-file)
 
-
 (provide 'siren-github)
+;;; siren-github.el ends here

modules/siren-global-keybindings.el

@@ -1,6 +1,10 @@
-;;
-;; global keybindings (customized)
-;;
+;;; siren-global-keybindings.el --- jimeh's Emacs Siren: Global keybindings.
+
+;;; Commentary:
+
+;; Basic global keybindings.
+
+;;; Code:
 
 (require 'siren-helpers)
 
@@ -77,6 +81,5 @@
   (global-set-key (kbd "s-<left>") 'beginning-of-line)
   (global-set-key (kbd "s-<right>") 'end-of-line))
 
-
-
 (provide 'siren-global-keybindings)
+;;; siren-global-keybindings.el ends here

modules/siren-go.el

@@ -1,6 +1,10 @@
-;;
-;; go
-;;
+;;; siren-go.el --- jimeh's Emacs Siren: go-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for go-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -63,5 +67,5 @@
      (add-hook 'go-mode-hook (lambda ()
                                (run-hooks 'siren-go-mode-hook)))))
 
-
 (provide 'siren-go)
+;;; siren-go.el ends here

modules/siren-goto-symbol.el

@@ -1,6 +1,10 @@
-;;
-;; goto-symbol
-;;
+;;; siren-goto-symbol.el --- jimeh's Emacs Siren: goto-symbol.
+
+;;; Commentary:
+
+;; Basic goto-symbol functionality.
+
+;;; Code:
 
 ;; Shamelessly ripped from Emacs Prelude.
 
@@ -59,5 +63,5 @@
 (global-set-key (kbd "C-t") 'siren-goto-symbol)
 (global-set-key (kbd "C-c C-t") 'siren-flush-cache-and-goto-symbol)
 
-
 (provide 'siren-goto-symbol)
+;;; siren-goto-symbol ends here.

modules/siren-haml.el

@@ -1,6 +1,10 @@
-;;
-;; haml
-;;
+;;; siren-haml.el --- jimeh's Emacs Siren: haml-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for haml-mode.
+
+;;; Code:
 
 (siren-require-packages '(haml-mode))
 
@@ -19,5 +23,5 @@
 
 (add-hook 'haml-mode-hook (lambda () (run-hooks 'siren-haml-mode-hook)))
 
-
 (provide 'siren-haml)
+;;; siren-haml.el ends here

modules/siren-helm.el

@@ -1,6 +1,10 @@
-;;
-;; helm
-;;
+;;; siren-helm.el --- jimeh's Emacs Siren: helm configuration.
+
+;;; Commentary:
+
+;; Basic configuration for helm.
+
+;;; Code:
 
 (siren-require-packages '(helm helm-swoop helm-projectile helm-open-github))
 
@@ -35,5 +39,5 @@
 (global-set-key (kbd "C-c o i") 'helm-open-github-from-issues)
 (global-set-key (kbd "C-c o p") 'helm-open-github-from-pull-requests)
 
-
 (provide 'siren-helm)
+;;; siren-helm.el ends here

modules/siren-highlight-indentation.el

@@ -1,6 +1,10 @@
-;;
-;; highlight-indentation
-;;
+;;; siren-highlight-indentation.el --- jimeh's Emacs Siren: highlight-indentation-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for highlight-indentation-mode.
+
+;;; Code:
 
 (siren-require-packages '(highlight-indentation))
 
@@ -10,3 +14,4 @@
 
 
 (provide 'siren-highlight-indentation)
+;;; siren-highlight-indentation.el ends here

modules/siren-highlight-symbol.el

@@ -1,6 +1,10 @@
-;;
-;; highlight-symbol
-;;
+;;; siren-highlight-symbol.el --- jimeh's Emacs Siren: highlight-symbol configuration.
+
+;;; Commentary:
+
+;; Basic configuration for highlight-symbol.
+
+;;; Code:
 
 (siren-require-packages '(highlight-symbol))
 
@@ -14,3 +18,4 @@
 
 
 (provide 'siren-highlight-symbol)
+;;; siren-highlight-symbol.el ends here

modules/siren-ido.el

@@ -1,6 +1,10 @@
-;;
-;; ido relateed
-;;
+;;; siren-ido.el --- jimeh's Emacs Siren: ido configuration.
+
+;;; Commentary:
+
+;; Basic configuration for ido.
+
+;;; Code:
 
 (siren-require-packages '(ido-ubiquitous ido-vertical-mode smex))
 
@@ -32,5 +36,5 @@
 (global-set-key (kbd "M-x") 'smex)
 (global-set-key (kbd "M-X") 'smex-major-mode-commands)
 
-
-(provide 'siren-ido)
+(provide 'siren-ido)
+;;; siren-ido.el ends here

modules/siren-js.el

@@ -1,4 +1,4 @@
-;;; siren-js.el --- jimeh's Emacs setup: js-mode configuration.
+;;; siren-js.el --- jimeh's Emacs Siren: js-mode configuration.
 
 ;;; Commentary:
 

modules/siren-json.el

@@ -1,4 +1,4 @@
-;;; siren-json.el --- jimeh's Emacs setup: json-mode configuration.
+;;; siren-json.el --- jimeh's Emacs Siren: json-mode configuration.
 
 ;;; Commentary:
 
@@ -9,7 +9,6 @@
 (require 'siren-programming)
 
 (siren-require-packages '(json-mode))
-;; (require 'json-mode)
 
 (defun siren-json-mode-defaults ()
   "Default tweaks for `json-mode'."

modules/siren-linum-relative.el

@@ -1,9 +1,13 @@
-;;
-;; linum-relative
-;;
+;;; siren-linum-relative.el --- jimeh's Emacs Siren: linum-relative configuration.
+
+;;; Commentary:
+
+;; Basic configuration for linum-relative.
+
+;;; Code:
 
 (siren-require-packages '(linum-relative))
 (require 'linum-relative)
 
-
 (provide 'siren-linum-relative)
+;;; siren-linum-relative.el ends here

modules/siren-linum.el

@@ -1,6 +1,10 @@
-;;
-;; linum
-;;
+;;; siren-linum.el --- jimeh's Emacs Siren: linum configuration.
+
+;;; Commentary:
+
+;; Basic configuration for linum.
+
+;;; Code:
 
 ;; Customize line numbers - In gui mode the fringe is the spacer between line
 ;; numbers and code, while in console mode we add an extra space for it.
@@ -12,3 +16,4 @@
 (require 'linum+)
 
 (provide 'siren-linum)
+;;; siren-linum.el ends here

modules/siren-lisp.el

@@ -1,6 +1,10 @@
-;;
-;; lisp
-;;
+;;; siren-lisp.el --- jimeh's Emacs Siren: lisp-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for lisp-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 (siren-require-packages '(rainbow-delimiters))
@@ -30,5 +34,5 @@
 
 (setq siren-interactive-lisp-coding-hook 'siren-interactive-lisp-coding-defaults)
 
-
 (provide 'siren-lisp)
+;;; siren-lisp.el ends here

modules/siren-lua.el

@@ -1,6 +1,10 @@
-;;
-;; lua
-;;
+;;; siren-lua.el --- jimeh's Emacs Siren: lua-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for lua-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -20,5 +24,5 @@
 (add-hook 'lua-mode-hook (lambda ()
                           (run-hooks 'siren-lua-mode-hook)))
 
-
 (provide 'siren-lua)
+;;; siren-lua.el ends here

modules/siren-magit.el

@@ -1,6 +1,10 @@
-;;
-;; magit
-;;
+;;; siren-magit.el --- jimeh's Emacs Siren: magit configuration.
+
+;;; Commentary:
+
+;; Basic configuration for magit.
+
+;;; Code:
 
 (siren-require-packages '(magit))
 
@@ -43,5 +47,5 @@
 (add-hook 'git-commit-mode-hook (lambda ()
                                   (run-hooks 'siren-git-commit-mode-hook)))
 
-
 (provide 'siren-magit)
+;;; siren-magit.el ends here

modules/siren-makefile.el

@@ -1,6 +1,10 @@
-;;
-;; makefile
-;;
+;;; siren-makefile.el --- jimeh's Emacs Siren: makefile-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for makefile-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -19,5 +23,5 @@
 (add-hook 'makefile-mode-hook (lambda ()
                                 (run-hooks 'siren-makefile-mode-hook)))
 
-
 (provide 'siren-makefile)
+;;; siren-makefile.el ends here

modules/siren-markdown.el

@@ -1,6 +1,10 @@
-;;
-;; sass
-;;
+;;; siren-markdown.el --- jimeh's Emacs Siren: markdown-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for markdown-mode.
+
+;;; Code:
 
 (siren-require-packages '(markdown-mode))
 
@@ -28,5 +32,5 @@
 
 (add-hook 'markdown-mode-hook (lambda () (run-hooks 'siren-markdown-mode-hook)))
 
-
 (provide 'siren-markdown)
+;;; siren-markdown.el ends here

modules/siren-move-beginning-of-line.el

@@ -1,9 +1,11 @@
-;;
-;; move-beginning-of-line
-;;
+;;; siren-move-beginning-of-line.el --- jimeh's Emacs Siren: move-beginning-of-line.
+
+;;; Commentary:
+
+;; Tweak behavior of C-a.
+
+;;; Code:
 
-;; Borrowed from:
-;;  - http://emacsredux.com/blog/2013/05/22/smarter-navigation-to-the-beginning-of-a-line/
 (defun siren-move-beginning-of-line (arg)
   "Move point back to indentation of beginning of line.
 
@@ -13,7 +15,9 @@ Effectively toggle between the first non-whitespace character and
 the beginning of the line.
 
 If ARG is not nil or 1, move forward ARG - 1 lines first.  If
-point reaches the beginning or end of the buffer, stop there."
+point reaches the beginning or end of the buffer, stop there.
+
+Borrowed from: http://emacsredux.com/blog/2013/05/22/smarter-navigation-to-the-beginning-of-a-line/"
   (interactive "^p")
   (setq arg (or arg 1))
 
@@ -30,5 +34,5 @@ point reaches the beginning or end of the buffer, stop there."
 ;; Use siren-move-beginning-of-line
 (global-set-key (kbd "C-a") 'siren-move-beginning-of-line)
 
-
 (provide 'siren-move-beginning-of-line)
+;;; siren-move-beginning-of-line.el ends here

modules/siren-multiple-cursors.el

@@ -1,6 +1,10 @@
-;;
-;; multiple-cursors
-;;
+;;; siren-multiple-cursors.el --- jimeh's Emacs Siren: multiple-cursors configuration.
+
+;;; Commentary:
+
+;; Basic configuration for multiple-cursors.
+
+;;; Code:
 
 (siren-require-packages '(multiple-cursors))
 
@@ -9,7 +13,7 @@
 
 (global-set-key (kbd "C-x C-@") 'mc/edit-lines)   ;; Terminal
 (global-set-key (kbd "C-x C-SPC") 'mc/edit-lines) ;; GUI
-    
+
 (global-set-key (kbd "M-/") 'mc/mark-next-like-this)
 (global-set-key (kbd "M-m") 'mc/mark-previous-like-this)
 (global-set-key (kbd "C-c M-/") 'mc/mark-all-like-this)
@@ -19,5 +23,5 @@
 (global-unset-key (kbd "M-<down-mouse-1>")) ;; must unset key first
 (global-set-key (kbd "M-<mouse-1>") 'mc/add-cursor-on-click)
 
-
-(provide 'siren-multiple-cursors)
+(provide 'siren-multiple-cursors)
+;;; siren-multiple-cursors.el ends here

modules/siren-neotree.el

@@ -1,6 +1,10 @@
-;;
-;; neotree
-;;
+;;; siren-neotree.el --- jimeh's Emacs Siren: neotree configuration.
+
+;;; Commentary:
+
+;; Basic configuration for neotree.
+
+;;; Code:
 
 (siren-require-packages '(neotree))
 
@@ -13,3 +17,4 @@
 (setq neo-window-width 54)
 
 (provide 'siren-neotree)
+;;; siren-neotree.el ends here

modules/siren-perspective.el

@@ -1,6 +1,10 @@
-;;
-;; perspective
-;;
+;;; siren-perspective.el --- jimeh's Emacs Siren: perspective configuration.
+
+;;; Commentary:
+
+;; Basic configuration for perspective.
+
+;;; Code:
 
 (siren-require-packages '(perspective))
 
@@ -35,5 +39,5 @@
 
 (persp-mode)
 
-
 (provide 'siren-perspective)
+;;; siren-perspective.el ends here

modules/siren-phi-search.el

@@ -1,6 +1,10 @@
-;;
-;; phi-search
-;;
+;;; siren-phi-search.el --- jimeh's Emacs Siren: phi-search configuration.
+
+;;; Commentary:
+
+;; Basic configuration for phi-search.
+
+;;; Code:
 
 (siren-require-packages '(phi-search))
 
@@ -8,5 +12,5 @@
 (global-set-key (kbd "C-s") 'phi-search)
 (global-set-key (kbd "C-r") 'phi-search-backward)
 
-
-(provide 'siren-phi-search)
+(provide 'siren-phi-search)
+;;; siren-phi-search.el ends here

modules/siren-programming.el

@@ -1,6 +1,10 @@
-;;
-;; programming
-;;
+;;; siren-programming.el --- jimeh's Emacs Siren: defaults for programming modes
+
+;;; Commentary:
+
+;; Basic configuration shared across all programming languages.
+
+;;; Code:
 
 (require 'siren-fci)
 (require 'siren-flycheck)
@@ -32,3 +36,4 @@
 
 
 (provide 'siren-programming)
+;;; siren-programming.el ends here

modules/siren-project-explorer.el

@@ -1,6 +1,10 @@
-;;
-;; project-explorer
-;;
+;;; siren-project-explorer.el --- jimeh's Emacs Siren: project-explorer configuration.
+
+;;; Commentary:
+
+;; Basic configuration for project-explorer.
+
+;;; Code:
 
 (siren-require-packages '(project-explorer))
 
@@ -26,5 +30,5 @@
             (pe/show-buffer buffer)))
         ))
 
-
 (provide 'siren-project-explorer)
+;;; siren-project-explorer.el ends here

modules/siren-projectile.el

@@ -1,6 +1,10 @@
-;;
-;; projectile
-;;
+;;; siren-projectile.el --- jimeh's Emacs Siren: projectile configuration.
+
+;;; Commentary:
+
+;; Basic configuration for projectile.
+
+;;; Code:
 
 (siren-require-packages '(projectile))
 
@@ -41,7 +45,6 @@
 ;; (setq projectile-known-projects-file (expand-file-name
 ;;                                      "projectile-bookmarks.eld" siren-savefile-dir))
 
-
 (projectile-global-mode t)
 
 ;; Keybindings
@@ -51,5 +54,5 @@
 (global-set-key (kbd "C-x C-v") 'projectile-switch-to-buffer)
 (global-set-key (kbd "C-c C-s") 'projectile-switch-project)
 
-
 (provide 'siren-projectile)
+;;; siren-projectile.el ends here

modules/siren-ruby.el

@@ -1,6 +1,10 @@
-;;
-;; ruby
-;;
+;;; siren-ruby.el --- jimeh's Emacs Siren: ruby-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for ruby-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 (require 'siren-company)
@@ -79,5 +83,5 @@
 ;;       (auto-complete)
 ;;     ad-do-it))
 
-
 (provide 'siren-ruby)
+;;; siren-ruby.el ends here

modules/siren-sass.el

@@ -1,6 +1,10 @@
-;;
-;; sass
-;;
+;;; siren-sass.el --- jimeh's Emacs Siren: sass-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for sass-mode.
+
+;;; Code:
 
 (require 'siren-css)
 (siren-require-packages '(sass-mode))
@@ -15,5 +19,5 @@
 
 (add-hook 'sass-mode-hook (lambda () (run-hooks 'siren-sass-mode-hook)))
 
-
 (provide 'siren-sass)
+;;; siren-sass.el ends here

modules/siren-scroll-half-screen.el

@@ -1,6 +1,10 @@
-;;
-;; scroll-half-screen
-;;
+;;; siren-scroll-half-screen.el --- jimeh's Emacs Siren: scroll-half-screen.
+
+;;; Commentary:
+
+;; Scroll up/down M-v/C-v half a screen instead of a full screen.
+
+;;; Code:
 
 ;; Scroll half a screen when using scroll-up and scroll-down functions.
 (defadvice scroll-up (around half-window activate)
@@ -13,5 +17,5 @@
         (max 1 (/ (1- (window-height (selected-window))) 2)))
   ad-do-it)
 
-
-(provide 'siren-scroll-half-screen)
+(provide 'siren-scroll-half-screen)
+;;; siren-scroll-half-screen.el ends here

modules/siren-scss.el

@@ -1,6 +1,10 @@
-;;
-;; scss
-;;
+;;; siren-scss.el --- jimeh's Emacs Siren: scss-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for scss-mode.
+
+;;; Code:
 
 (require 'siren-css)
 (siren-require-packages '(scss-mode))
@@ -15,5 +19,5 @@
 
 (add-hook 'scss-mode-hook (lambda () (run-hooks 'siren-scss-mode-hook)))
 
-
 (provide 'siren-scss)
+;;; siren-scss.el ends here

modules/siren-sh.el

@@ -1,6 +1,10 @@
-;;
-;; shell
-;;
+;;; siren-sh.el --- jimeh's Emacs Siren: sh-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for sh-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -22,5 +26,5 @@
 (add-hook 'sh-mode-hook (lambda ()
                           (run-hooks 'siren-sh-mode-hook)))
 
-
 (provide 'siren-sh)
+;;; siren-sh.el ends here

modules/siren-smartparens.el

@@ -1,6 +1,10 @@
-;;
-;; smartparens
-;;
+;;; siren-smartparens.el --- jimeh's Emacs Siren: smartparens configuration.
+
+;;; Commentary:
+
+;; Basic configuration for smartparens.
+
+;;; Code:
 
 (siren-require-packages '(smartparens))
 
@@ -22,5 +26,5 @@
 ;; Aliases
 (defalias 'rw 'sp-rewrap-sexp)
 
-
 (provide 'siren-smartparens)
+;;; siren-smartparens.el ends here

modules/siren-smex.el

@@ -1,6 +1,10 @@
-;;
-;; smex
-;;
+;;; siren-smex.el --- jimeh's Emacs Siren: smex.
+
+;;; Commentary:
+
+;; Replace M-x with the more powerful smex.
+
+;;; Code:
 
 (siren-require-packages '(smex))
 
@@ -16,5 +20,5 @@
 (global-set-key (kbd "C-c C-m") 'smex)
 (global-set-key (kbd "C-c C-c M-x") 'execute-extended-command)
 
-
-(provide 'siren-smex)
+(provide 'siren-smex)
+;;; siren-smex.el ends here

modules/siren-text-manipulation.el

@@ -1,15 +1,17 @@
-;;
-;; text-manipulation
-;;
+;;; siren-text-manipulation.el --- jimeh's Emacs Siren: text-manipulation.
+
+;;; Commentary:
+
+;; Various text manipulation functions and keybindings. Some of them shamelessly
+;; ripped from textmate.el: https://github.com/defunkt/textmate.el
+
+;;; Code:
 
 (siren-require-packages '(move-text expand-region))
 
 (require 'move-text)
 (require 'expand-region)
 
-;; Various things shamelessly ripped from textmate.el:
-;;  - https://github.com/defunkt/textmate.el
-
 (defmacro allow-line-as-region-for-function (orig-function)
 `(defun ,(intern (concat (symbol-name orig-function) "-or-line"))
    ()
@@ -43,7 +45,6 @@ A place is considered `tab-width' character columns."
   (interactive)
   (siren-shift-right (* -1 (or arg 1))))
 
-
 ;; Keybindings
 (define-key global-map (kbd "M-p") 'move-text-up)
 (define-key global-map (kbd "M-n") 'move-text-down)
@@ -57,5 +58,5 @@ A place is considered `tab-width' character columns."
 (global-set-key (kbd "M-.") 'er/expand-region)
 (global-set-key (kbd "M-,") 'er/contract-region)
 
-
 (provide 'siren-text-manipulation)
+;;; siren-text-manipulation.el ends here

modules/siren-thrift.el

@@ -1,6 +1,10 @@
-;;
-;; coffeescript
-;;
+;;; siren-thrift.el --- jimeh's Emacs Siren: thrift-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for thrift-mode.
+
+;;; Code:
 
 (require 'siren-programming)
 
@@ -19,5 +23,5 @@
 (add-hook 'thrift-mode-hook (lambda ()
                               (run-hooks 'siren-thrift-mode-hook)))
 
-
 (provide 'siren-thrift)
+;;; siren-thrift.el ends here

modules/siren-volatile-highlights.el

@@ -1,6 +1,10 @@
-;;
-;; volatile highlights
-;;
+;;; siren-volatile-highlights.el --- jimeh's Emacs Siren: volatile-highlights-mode configuration.
+
+;;; Commentary:
+
+;; Basic configuration for volatile-highlights-mode.
+
+;;; Code:
 
 (siren-require-packages '(volatile-highlights))
 
@@ -8,5 +12,5 @@
 (volatile-highlights-mode t)
 (diminish 'volatile-highlights-mode)
 
-
 (provide 'siren-volatile-highlights)
+;;; siren-volatile-highlights.el ends here

modules/siren-window-management.el

@@ -1,6 +1,10 @@
-;;
-;; window-management
-;;
+;;; siren-window-management.el --- jimeh's Emacs Siren: window-management.
+
+;;; Commentary:
+
+;; Basic window management stuff.
+
+;;; Code:
 
 (defun ignore-error-wrapper (fn)
   "Funtion return new function that ignore errors.
@@ -10,7 +14,6 @@
       (interactive)
       (ignore-errors
         (funcall fn)))))
-        
 
 (siren-require-packages '(buffer-move))
 
@@ -29,5 +32,5 @@
 (global-set-key (kbd "M-J") 'buf-move-left)
 (global-set-key (kbd "M-L") 'buf-move-right)
 
-
-(provide 'siren-window-management)
+(provide 'siren-window-management)
+;;; siren-window-management.el ends here

modules/siren-workgroups2.el

@@ -1,6 +1,10 @@
-;;
-;; workgroups2
-;;
+;;; siren-workgroups2.el --- jimeh's Emacs Siren: workgroups2 configuration.
+
+;;; Commentary:
+
+;; Basic configuration for workgroups2.
+
+;;; Code:
 
 (siren-require-packages '(workgroups2))
 
@@ -9,3 +13,4 @@
 
 
 (provide 'siren-workgroups2)
+;;; siren-workgroups2.el ends here

modules/siren-yasnippet.el

@@ -1,6 +1,10 @@
-;;
-;; yasnippet
-;;
+;;; siren-yasnippet.el --- jimeh's Emacs Siren: yasnippet configuration.
+
+;;; Commentary:
+
+;; Basic configuration for yasnippet.
+
+;;; Code:
 
 (siren-require-packages '(yasnippet))
 
@@ -9,5 +13,5 @@
 
 (yas/global-mode t)
 
-
 (provide 'siren-yasnippet)
+;;; siren-yasnippet.el ends here

siren-modules.el

@@ -1,6 +1,10 @@
-;;
-;; siren modules setup
-;;
+;;; siren-modules.el --- jimeh's Emacs Siren: Module loading.
+
+;;; Commentary:
+
+;; Load the modules!
+
+;;; Code:
 
 ;; Modules
 (require 'siren-aliases)
@@ -42,7 +46,6 @@
 ;; (require 'siren-perspective)
 ;; (require 'siren-workgroups2)
 
-
 ;; Languages
 (require 'siren-coffee)
 (require 'siren-css)
@@ -60,5 +63,5 @@
 (require 'siren-sh)
 (require 'siren-thrift)
 
-
 (provide 'siren-modules)
+;;; siren-modules.el ends here

siren-theme.el

@@ -1,10 +1,14 @@
-;;
-;; siren theme setup
-;;
+;;; siren-theme.el --- jimeh's Emacs Siren: Theme loading.
+
+;;; Commentary:
+
+;; Load the theme!
+
+;;; Code:
 
 (if window-system
   (require 'siren-theme-twilight-anti-bright)
   (require 'siren-theme-tomorrow-night-paradise))
 
-
 (provide 'siren-theme)
+;;; siren-theme.el ends here

themes/siren-theme-tomorrow-night-paradise.el

@@ -1,8 +1,12 @@
-;;
-;; tomorrow-night-paradise-theme
-;;
+;;; siren-tomorrow-night-paradise-theme.el --- jimeh's Emacs Siren: tomorrow-night-paradise-theme.
+
+;;; Commentary:
+
+;; Setup for tomorrow-night-paradise-theme.
+
+;;; Code:
 
 (require 'tomorrow-night-paradise-theme)
 
-
-(provide 'siren-theme-tomorrow-night-paradise)
+(provide 'siren-theme-tomorrow-night-paradise)
+;;; siren-tomorrow-night-paradise-theme.el ends here

themes/siren-theme-twilight-anti-bright.el

@@ -1,10 +1,14 @@
-;;
-;; twilight-anti-bright-theme
-;;
+;;; siren-twilight-anti-bright-theme.el --- jimeh's Emacs Siren: twilight-anti-bright-theme.
+
+;;; Commentary:
+
+;; Setup for twilight-anti-bright-theme.
+
+;;; Code:
 
 (siren-require-packages '(twilight-anti-bright-theme twilight-bright-theme))
 
 (require 'twilight-anti-bright-theme)
 
-
-(provide 'siren-theme-twilight-anti-bright)
+(provide 'siren-theme-twilight-anti-bright)
+;;; siren-twilight-anti-bright-theme.el ends here