@@ -1,8 +1,56 @@
 * Dotfiles
 
-I've organised this repository with [[https://github.com/thoughtbot/rcm][rcm]], using tag- and
-host-specific directories. It focuses on zsh and emacs, with some
-functions to go from zsh to emacs (and directly to dired and magit).
-It doesn't use any configuration frameworks.
+I've organised this repository with [[https://www.gnu.org/software/stow/][GNU Stow]].  It focuses on [[http://zsh.sourceforge.net][Z Shell]] and
+[[http://emacs.sexy][Emacs]].
+
+It doesn't use any configuration frameworks, just packages installed
+via package managers.  For Z shell I use [[https://zplug.sh/][zplug]] and for Emacs I use the
+built-in package.el via [[https://github.com/jwiegley/use-package][use-package]].
+
+It should work on:
+- Linux
+- OSX
+- FreeBSD
+- Windows/Ubuntu
+
+** Installation
+
+Installing a set of dotfiles with stow is simple.  For example, with
+Emacs:
 
-Most likely to work on Linux, OSX and FreeBSD.
+#+BEGIN_SRC sh :exports code
+stow -S emacs
+#+END_SRC
+
+And then to uninstall
+
+#+BEGIN_SRC sh :exports code
+stow -D emacs
+#+END_SRC
+
+*** Z Shell
+
+My zsh configuration uses [[https://zplug.sh/][zplug]], so that will need to be installed:
+
+#+BEGIN_SRC sh :exports code
+git clone git://github.com/zplug/zplug ~/projects/zplug/
+#+END_SRC
+
+To install the packages:
+
+#+BEGIN_SRC sh :exports code
+zsh -ic "zplug install"
+#+END_SRC
+
+Note that this will log some errors about a pipe, but that's okay.
+zplug is meant to be used in a real interactive shell.
+
+*** Emacs
+
+I use org-mode for my Emacs init file.  To simplify setup, I created a
+[[file:emacs/.emacs.d/Makefile][Makefile]].
+
+#+BEGIN_SRC sh :exports code
+cd ~/.emacs.d/
+make
+#+END_SRC

@@ -0,0 +1,22 @@
+define EMACS_TANGLE
+(progn\
+  (setq vc-follow-symlinks nil)\
+  (find-file \"init.org\")\
+  (require 'ob-tangle)\
+  (org-babel-tangle nil \"init.el\"))
+endef
+
+# The first target is the default.  `all` is typically defined here.
+all: init.elc
+
+# These targets don't pertain to files
+.PHONY: all clean
+
+init.el:
+	@emacs --batch --no-init-file --eval "$(EMACS_TANGLE)" --kill
+
+init.elc: init.el
+	@emacs --batch --no-init-file --funcall batch-byte-compile init.el
+
+clean:
+	rm init.el init.elc

Not showing binary file.

@@ -1,1 +0,0 @@
-gem: --user-install -n~/bin

@@ -1,17 +0,0 @@
-#!/bin/sh
-
-EMACS_COMMAND=$(command -v Emacs || command -v emacs)
-
-if [[ -s $EMACS_COMMAND ]]
-then
-  pushd ~/.emacs.d
-  emacs --batch --eval "(progn
-(setq vc-follow-symlinks nil)
-(find-file \"init.org\")
-(require 'ob-tangle)
-(org-babel-tangle nil \"init.el\")
-(byte-compile-file \"init.el\")
-(load-file \"init.el\")
-)"
-  popd
-fi

@@ -1,29 +0,0 @@
-#!/usr/bin/env zsh
-ZDOTDIR="${XDG_CONFIG_HOME:=~/.config}/zsh"
-
-pushd $ZDOTDIR
-for f in z*(-.)
-do
-  if [[ -e .$f ]]
-  then
-    if [[ ! -h .$f ]]
-    then
-      echo ".$f already exists as a regular file, ignoring"
-    fi
-  else
-    ln -s $f .$f
-  fi
-done
-popd
-
-if [[ ! -d ~/.cache/zsh ]]
-then
-  mkdir -p ~/.cache/zsh
-fi
-
-if [[ -z $commands[zplug] && ! -d ~/projects/zplug/ ]]
-then
-  git clone git://github.com/zplug/zplug ~/projects/zplug/
-fi
-
-zsh -ic "zplug install"

@@ -1,9 +0,0 @@
-# -*- mode: sh; -*-
-if [[ -e $HOME/.nix-profile/etc/profile.d/nix.sh ]]
-then
-  . $HOME/.nix-profile/etc/profile.d/nix.sh;
-fi
-
-JIRA_RAPID_BOARD=true
-JIRA_URL=https://spotcap.atlassian.net
-EMAIL=alan.pearce@spotcap.com

Not showing binary file.

@@ -1,2 +0,0 @@
-DOTFILES_DIRS="$HOME/projects/dotfiles"
-TAGS="emacs git global tmux zsh"

@@ -1,4 +0,0 @@
-#include "main"
-
-Emacs.Font:                         -xos4-Terminus-normal-normal-normal-*-14-*-*-*-*-*-*-*
-Emacs.fixed-pitch.attributeFont:    -xos4-Terminus-normal-normal-normal-*-14-*-*-*-*-*-*-*

@@ -1,2 +0,0 @@
-DOTFILES_DIRS="$HOME/projects/dotfiles"
-TAGS="emacs git hg clojure ssh zsh"

@@ -1,3 +0,0 @@
-EXCLUDES="Brewfile LaunchAgents README.org"
-DOTFILES_DIRS="$HOME/projects/dotfiles"
-[ -e ~/.rcrc.local ] && . ~/.rcrc.local

@@ -0,0 +1,1 @@
+gem: --user-install -n~/.local/bin

@@ -300,7 +300,12 @@
 #+BEGIN_SRC emacs-lisp
 (use-package beacon
   :diminish beacon-mode
-  :config (beacon-mode +1))
+  :config (progn
+            (beacon-mode +1)
+            (setq beacon-blink-delay 0.25
+                  beacon-blink-duration 0.25
+                  beacon-size 20
+                  beacon-color "#a1b56c")))
 #+END_SRC
 
 ** Renaming major modes
@@ -423,7 +428,7 @@
 #+BEGIN_SRC emacs-lisp
 (defun switch-to-dotfiles ()
   (interactive)
-  (projectile-switch-project-by-name (expand-file-name "dotfiles" home-project-directory)))
+  (projectile-switch-project-by-name (expand-file-name "~/dotfiles")))
 #+END_SRC
 
 ** The Silver Searcher
@@ -446,8 +451,9 @@ (use-package ripgrep
   :if (executable-find "rg"))
 
 (use-package projectile-ripgrep
-  :bind (("C-c p s r" . projectile-ripgrep))
-  :ensure nil)
+  :after (ripgrep projectile)
+  :if (executable-find "rg")
+  :bind (("C-c p s r" . projectile-ripgrep)))
 #+END_SRC
 
 ** Projectile
@@ -1730,7 +1736,7 @@ A nice completion backend for programming modes.
 
 #+BEGIN_SRC emacs-lisp
 (use-package ggtags
-  :disabled t
+  :if (executable-find "gtags")
   :commands turn-on-ggtags-mode
   :functions (ggtags-navigation-mode-abort)
   :config (progn
@@ -1740,6 +1746,21 @@ (defun turn-on-ggtags-mode ()
             (interactive)
             (ggtags-mode 1))
           (add-hook 'c-mode-common-hook #'turn-on-ggtags-mode)))
+#+END_SRC
+
+** dumb-jump
+
+A "clever" way of implementing go-to-definition across languages: use
+a project-wide text search and apply heuristics to the results to
+guess a definition.
+
+#+BEGIN_SRC emacs-lisp
+(use-package dumb-jump
+  :bind (("M-g o" . dumb-jump-go-other-window)
+         ("M-g j" . dumb-jump-go)
+         ("M-g x" . dumb-jump-go-prefer-external)
+         ("M-g z" . dumb-jump-go-prefer-external-other-window))
+  :config (setq dumb-jump-selector 'ivy))
 #+END_SRC
 
 ** Lisps

@@ -17,6 +17,11 @@ then
     export SSH_AUTH_SOCK=${XDG_RUNTIME_DIR:-/run/user/$UID}/ssh-agent
   fi
 
+  if [[ -e $HOME/.nix-profile/etc/profile.d/nix.sh ]]
+  then
+    . $HOME/.nix-profile/etc/profile.d/nix.sh;
+  fi
+
   case $OSTYPE in
     darwin*)
       os=darwin
@@ -40,4 +45,7 @@ *)
       arch=386
       ;;
   esac
+
+  export GTAGSCONF=~/.globalrc
+  export GTAGSLABEL=ctags
 fi

@@ -2,7 +2,6 @@ # -*- mode: sh; -*-
 source $ZPLUG_HOME/init.zsh
 
 zplug "zsh-users/zsh-completions", depth:1, defer:0
-zplug "Tarrasch/zsh-autoenv", as:plugin
 zplug "junegunn/fzf-bin", from:gh-r, as:command, rename-to:fzf
 zplug "junegunn/fzf", as:plugin, use:"shell/*.zsh", defer:2
 zplug "junegunn/fzf", as:command, use:"bin/*"
@@ -134,18 +133,16 @@ then
   eval $(ssh-agent)
 fi
 
-if zplug check Tarrasch/zsh-autoenv
+if zplug check gerges/oh-my-zsh-jira-plus
 then
-  AUTOENV_FILE_ENTER=.envrc
-  AUTOENV_HANDLE_LEAVE=1
-  AUTOENV_LOOK_UPWARDS=1
+  JIRA_RAPID_BOARD=true
+  JIRA_URL=https://spotcap.atlassian.net
 fi
 
 # Then, source plugins and add commands to $PATH
 zplug load
 
 # General configuration
-setopt auto_cd          # Change directories without `cd`
 
 if [[ -n $commands[hub] ]]
 then