dotfiles

My dotfiles and scripts, and configuration. The shell part is specific for Zsh, using zinit & powerlevel10k.

Modularity

The files are managed by GNU Stow, divided by tool or functional area: Git, emacs, etc—see the top level-directories. Different systems use different subsets of configuration, specified by some files, as described in the installation section.

Emacs

The biggest part of configuration is for Emacs 30 or newer. The focus is on seamless integration between all the different packages, avoiding surprises, and adding polish here and there. Of course, that is very much a work in progress.

I have started splitting out logical units into standalone Elisp packages, where it makes sense, to increase maintainability:

• org-autotask: Org agenda views, clocking, automation.

The bulk of configuration is in my-setup.el, along with some parts split into its own files in the same directory, there is also early-init.el and init.el. There is also some system-specific setup over at darwin.el.

I am not using literate configuration, which seems to be very popular among Org users at least. Maybe I should. Likewise for use-package.

Configured packages

I always prefer a melpa-stable version, if available and not broken. Unfortunately, that is not always possible.

The big ones

org magit and forge lsp-mode flycheck company projectile mu4e

Major

GCMH org-roam wgrep org-gcal vterm deadgrep undo-tree

Nice to have, niche, & specific major modes

dispwatch lsp-treemacs calfw iedit eldoc-cmake aggressive-indent-mode yaml-mode markdown-mode bison-mode cmake-mode grab-mac-link beginend git-modes flycheck-google-cpplint difftastic.el pr-review

Appearance

solarized-theme git-gutter-fringe page-break-lines xterm-color all-the-icons-dired cmake-font-lock beacon flycheck-status-emoji stripe-buffer prism.el info-colors org-sticky-header

Packages bundled with Emacs

tramp ts which-key

Improvements, fixed annoyances, and bug workarounds

• Disable global-display-fill-column-indicator in read-only buffers
• macOS: add the missing man page paths for woman
• Re-enable Shellcheck if using lsp-mode with bash-language-server
• Clicking on URLs should open them instead of spell checking them
• Enable the dynamic Projectile mode line for remote projects
• Reduce LSP info in the modeline
• Show Git ignored files in dired-ignored face

Custom commands and functionality

• Set frame geometry after docking/undocking laptop automatically
• kill-buffers-rm-worktree: bound to y in the Projectile keymap, kills all buffers and executes gitrmworktree.

Installation

See INSTALLATION.md

New system setup

See setup-ubuntu.sh, setup-centos9.sh, and setup-macos.sh.

Dotfiles, Emacs distros, macOS defaults, etc. I have been stealing from

• Doom Emacs

• EmacsWiki: Dot Emacs Challenge

• https://sites.google.com/site/steveyegge2/my-dot-emacs-file

• https://emacs.nasy.moe/

• https://ebzzry.io/en/emacs-pairs/

• https://github.com/snackon/Witchmacs

• https://github.com/jhenahan/dots/tree/main/config/emacs

• https://github.com/link0ff/emacs-init

• https://www.lucacambiaghi.com/vanilla-emacs/readme.html

• https://emacs.stackexchange.com/a/17281/16376

• https://github.com/Bassmann/emacs-config/

• https://github.com/KaratasFurkan/.emacs.d/

• https://stackoverflow.com/questions/23344540/emacs-update-git-gutter-annotations-when-staging-or-unstaging-changes-in-magit

• https://www.reddit.com/r/emacs/comments/ja97xs/weekly_tipstricketc_thread/g985tg9

• https://irreal.org/blog/?p=6297

• https://www.reddit.com/r/emacs/comments/6iqtze/org_mreturn_annoyance/

• https://github.com/kaushalmodi/.emacs.d

• https://www.reddit.com/r/emacs/comments/74ruu0/how_to_copy_the_contents_of_a_single_cell_in_org/do0utjf/?context=3

• https://gitlab.com/gSwag/emacs-configuration

• https://ianyepan.github.io/posts/emacs-git-gutter/

• https://github.com/diamondBond/emacs

• https://github.com/aadi58002/stow-dotfiles/blob/main/.config/emacs/init.org

• https://github.com/thornjad/aero

• https://qua.name/mrb/an-org-babel-based-emacs-configuration

• https://github.com/michelegera/dotfiles

• https://pawelgrzybek.com/change-macos-user-preferences-via-command-line/

• https://github.com/mathiasbynens/dotfiles

• https://github.com/ryuta69/dotfiles/

• https://twitter.com/nibroc/status/963088893758259200

• https://github.com/geerlingguy/dotfiles

• https://github.com/caarlos0/dotfiles

• https://gitlab.com/bkhl/dotfiles

• https://macowners.club/

• https://metaredux.com/posts/2020/07/07/supercharge-your-bash-history.html

• https://www.topbug.net/blog/2017/07/31/inputrc-for-humans/

• https://twitter.com/trav_downs/status/1280004737455271936