README.md

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, currently version 29.1. 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 m4e

Major

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

Nice-to-have, niche, & specific major modes

rich-minority dispwatch lsp-treemacs calfw which-key keyfreq iedit eldoc-cmake aggressive-indent-mode yaml-mode markdown-mode ssh-config-mode bison-mode cmake-mode grab-mac-link cheat-sh beginend git-modes flycheck-google-cpplint difftastic.el pr-review

Appearance

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

Packages bundled with Emacs

tramp ts

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 spellchecking them
• Workaround the projectile issue of remote projects not being added to Projectile project list.
• Add Projectile reconfigure command for CMake presets.
• Automatically update git gutter on Magit actions.
• Disable color-identifiers-mode under LSP with semantic highlighting
• 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
• my-recompile-packages: force recompiling all the installed packages, after a Emacs version upgrade or a borked package upgrade.
• 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-centos6.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