Put doom emacs config in dotfiles

3 files changed, 550 insertions, 0 deletions

diff --git a/doom.d/config.el b/doom.d/config.el
new file mode 100644
index 0000000..e3e72c4
--- /dev/null
+++ b/doom.d/config.el
@@ -0,0 +1,304 @@
+;;; $DOOMDIR/config.el -*- lexical-binding: t; -*-
+
+;; Place your private configuration here! Remember, you do not need to run 'doom
+;; sync' after modifying this file!
+
+
+;; Some functionality uses this to identify you, e.g. GPG configuration, email
+;; clients, file templates and snippets. It is optional.
+(setq user-full-name "Matthew Lemon"
+      user-mail-address "matt@matthewlemon.com")
+
+;; Doom exposes five (optional) variables for controlling fonts in Doom:
+;;
+;; - `doom-font' -- the primary font to use
+;; - `doom-variable-pitch-font' -- a non-monospace font (where applicable)
+;; - `doom-big-font' -- used for `doom-big-font-mode'; use this for
+;;   presentations or streaming.
+;; - `doom-unicode-font' -- for unicode glyphs
+;; - `doom-serif-font' -- for the `fixed-pitch-serif' face
+;;
+(setq doom-font (font-spec :family "Iosevka Regular" :size 18)
+      doom-variable-pitch-font (font-spec :family "Iosevka Regular" :size 20))
+;;
+;; See 'C-h v doom-font' for documentation and more examples of what they
+;; accept. For example:
+;;
+;;(setq doom-font (font-spec :family "Fira Code" :size 12 :weight 'semi-light)
+;;      doom-variable-pitch-font (font-spec :family "Fira Sans" :size 13))
+;;
+;; If you or Emacs can't find your font, use 'M-x describe-font' to look them
+;; up, `M-x eval-region' to execute elisp code, and 'M-x doom/reload-font' to
+;; refresh your font settings. If Emacs still can't find your font, it likely
+;; wasn't installed correctly. Font issues are rarely Doom issues!
+
+;; There are two ways to load a theme. Both assume the theme is installed and
+;; available. You can either set `doom-theme' or manually load a theme with the
+;; `load-theme' function. This is the default:
+(setq doom-theme 'doom-gruvbox)
+
+;; This determines the style of line numbers in effect. If set to `nil', line
+;; numbers are disabled. For relative line numbers, set this to `relative'.
+(setq display-line-numbers-type t)
+
+;; If you use `org' and don't want your org files in the default location below,
+;; change `org-directory'. It must be set before org loads!
+;;
+;; Basic agenda stuff
+
+(after! org
+                (setq org-directory "~/org/")
+                (setq org-clock-persist 'history)
+                (org-clock-persistence-insinuate)
+                (setq org-agenda-span 'day)
+                (setq org-directory "~/org")
+                (setq org-agenda-files (quote ("~/org/home.org"
+                "~/org/projects.org"
+                "~/org/journal.org"
+                "~/org/work.org"
+                "~/org/notes.org"
+                "~/org/habits.org"
+                "~/org/calendar/cal.org")))
+                (setq org-default-notes-file (concat org-directory "/notes.org"))
+                (setq org-agenda-window-setup 'current-window)
+                (setq org-agenda-start-with-log-mode t)
+                (setq org-M-RET-may-split-line '(default . nil))
+                (setq org-enforce-todo-dependencies t)
+                (setq org-log-done 'time)
+                (setq org-log-done-with-time 'note)
+                (setq diary-file "~/org/diary")
+                (setq org-agenda-include-diary t)
+                (setq org-agenda-diary-file "~/org/calendar/cal.org")
+                (setq org-agenda-show-future-repeats t)
+                (setq org-agenda-skip-deadline-if-done t)
+                (setq org-agenda-skip-scheduled-if-done t)
+                (setq org-reverse-note-order t)
+                (setq org-habit-graph-column 45)
+                (setq org-sort-agenda-notime-is-late nil)
+                (setq org-columns-default-format "%50ITEM(Task) %10CLOCKSUM %25TIMESTAMP_IA")
+                (setq org-archive-location "~/org/archive.org::* From %s")
+                (setq org-refile-targets (quote ((nil :maxlevel . 9)
+                (org-agenda-files :maxlevel . 9))))
+
+                ;; Basic org keybindings
+                (global-set-key "\C-cl" 'org-store-link)
+                (global-set-key "\C-ca" 'org-agenda)
+                (global-set-key "\C-cb" 'org-iswitchb)
+                (global-set-key "\C-cc" 'org-capture)
+                ;;
+                ;; Agenda dispatcher
+                (setq org-agenda-custom-commands
+                '(("w" . "Work")
+                        ("wt" "Agenda + Work TODO"
+                        (
+                        (agenda "")
+                        (tags-todo "+@work-TODO=\"WAITING\"-SCHEDULED>=\"<today>\""
+                                ((org-agenda-overriding-header "Work TODO UNSCHEDULED")))
+                        (tags-todo "+@work+TODO=\"WAITING\""
+                                ((org-agenda-overriding-header "Work WAITING")))
+                        ))
+                        ("wn" "Agenda + Work NEXT"
+                        (
+                        (agenda)
+                        (tags-todo "+@work+TODO=\"NEXT\"-SCHEDULED>=\"<today>\""
+                                ((org-agenda-overriding-header "Work NEXT UNSCHEDULED")))
+                        (tags-todo "+@work+TODO=\"WAITING\""
+                                ((org-agenda-overriding-header "Work WAITING")))
+                        ))
+                        ("wp" "Work Project NEXT"
+                        (
+                        (agenda)
+                        (tags-todo "+@work+TODO=\"NEXT\"+CATEGORY=\"Project\""
+                                ((org-agenda-overriding-header "Work Project NEXT actions")))
+                        ))
+                        ("h" . "Home")
+                        ("hh" "Agenda + Home TODO"
+                        (
+                        (agenda "")
+                        (tags-todo "@home-SCHEDULED>=\"<today>\"-TODO=\"WAITING\"-TODO=\"DOING\""
+                                ((org-agenda-overriding-header "Home TODO UNSCHEDULED")
+                                (org-agenda-sorting-strategy '(deadline-down scheduled-down priority-down))))
+                        (tags-todo "+@home+TODO=\"WAITING\""
+                                ((org-agenda-overriding-header "Home WAITING")))
+                        (tags-todo "+@home+TODO=\"DOING\"" ((org-agenda-overriding-header "Home in progress")))
+                        ))
+                        ("hn" "Agenda + Home NEXT"
+                        (
+                        (agenda "")
+                        (tags-todo "+@home+TODO=\"NEXT\"-SCHEDULED>=\"<today>\""
+                                ((org-agenda-overriding-header "Home NEXT UNSCHEDULED")
+                                (org-agenda-sorting-strategy '(deadline-down scheduled-down priority-down))))
+                        (tags-todo "+@home+TODO=\"DOING\""
+                                ((org-agenda-overriding-header "Home in progress")))
+                        ))
+                        ("n" "Agenda + All NEXT"
+                        (
+                        (agenda "")
+                        (todo "NEXT")))
+                        ("t" "Agenda + All TODO"
+                        (
+                        (agenda "")
+                        (alltodo "")))
+                        ("W" "Agenda + All WAITING"
+                        (
+                        (agenda "")
+                        (todo "WAITING")))
+                        ("i" tags "idea")
+                        ))
+
+                ;; org capture templates
+                (setq org-capture-templates
+                      (quote (("h" "Home Tasks & Notes")
+                              ("ht" "Home TODO" entry (file+headline "~/org/home.org" "Single Actions")
+                               "** TODO %?\nEntered on %U\n"
+                               :prepend t)
+                              ("hn" "Home NEXT" entry (file+headline "~/org/home.org" "Single Actions")
+                               "** NEXT %?\nEntered on %U\n"
+                               :prepend t)
+                              ("hN" "Home Note" entry (file+headline "~/org/home.org" "Notes")
+                               "** %?\nEntered on %U\n")
+                              ("hj" "Journal" entry (file+datetree "~/org/journal.org")
+                               "* %?\nEntered on %U\n")
+                              ("hi" "Home Idea" entry (file+headline "~/org/notes.org" "Notes")
+                               "** %? :idea:\nEntered on %U\n")
+                              ("hc" "Home Calendar" entry (file+olp+datetree "~/org/calendar/cal.org" "Home Calendar")
+                               "* %?\n:PROPERTIES:\n%^G\n:END:\n%^T")
+                              ("w" "Work Tasks & Notes")
+                              ("wt" "Work TODO" entry (file+headline "~/org/work.org" "Single Actions")
+                               "** TODO %?\nEntered on %U\n"
+                               :prepend t)
+                              ("wn" "Work NEXT" entry (file+headline "~/org/work.org" "Single Actions")
+                               "** NEXT %?\nEntered on %U\n"
+                               :prepend t)
+                              ("wN" "Note" entry (file+headline "~/org/work.org" "Notes")
+                               "* %?\nEntered on %U\n")
+                              ("wc" "Note from Clipboard" entry (file+headline "~/org/work.org" "Notes")
+                               "* %?\n\t\n%c")
+                              ("wr" "Note from Region" entry (file+headline "~/org/work.org" "Notes")
+                               "* %?\n\t\n%i")
+                              ("wj" "Journal" entry (file+olp+datetree "~/org/work.org" "Journal")
+                               "** %?\nEntered on %U\n")
+                              ("wd" "Retrospective Single Action" entry (file+headline "~/org/work.org" "Single Actions")
+                               "* DONE %?\nCLOSED: %U")
+                              ("e" "Emacs Tip")
+                              ("et" "Emacs Tip" entry (file+headline "~/org/emacs-tips.org" "Emacs Tips")
+                               "* %?\n\t%a")
+                              ("er" "Emacs Tip from Region" entry (file+headline "~/org/emacs-tips.org" "Emacs Tips")
+                               "* %?\n\t%i")
+                              )))
+                ;; org tags
+                (setq org-tag-alist '(
+                        ;; Depth
+                        ("@immersive" . ?i) ;; "Deep"
+                        ("@process" . ?p)   ;; "Shallow"
+                        ("@offdesk" . ?o)   ;; "Away from desk"
+                        ;; Type
+                        ("brainstorm" . ?b)
+                        ("idea" . ?d)
+                        ;; Context
+                        ("@work" . ?w)
+                        ("@home" . ?h)
+                        ("@errand" . ?e)
+                        ("@emacs" . ?E)
+                        ;; Time
+                        ("15min" . ?<)
+                        ("30min" . ?=)
+                        ("1h" . ?>)
+                        ;; Energy
+                        ("Challenge" . ?1)
+                        ("Average" . ?2)
+                        ("Easy" . ?3)
+                        ;; Misc
+                        ("Maybe" . ?m)
+                        ))
+
+                ;; org agenda should be full screen
+                (defun open-agenda ()
+                "Open the org-agenda."
+                (interactive)
+                (let ((agenda "*Org Agenda*"))
+                (if (equal (get-buffer agenda) nil)
+                (org-agenda-list)
+                (unless (equal (buffer-name (current-buffer)) agenda)
+                (switch-to-buffer agenda))
+                (org-agenda-redo t)
+                (beginning-of-buffer))))
+
+                ;; org handling to-do items
+
+                ;; Put state transition logs into a drawer called LOGBOOK
+                (setq org-log-into-drawer t)
+
+                (setq org-todo-keywords
+                (quote ((sequence "TODO(t)" "NEXT(n)" "DOING" "|" "DONE(d!)")
+                (sequence "WAITING(w@/!)" "HOLD(h@/!)" "|" "CANCELLED(c@/!)")
+                )))
+
+                (setq org-todo-keyword-faces
+                (quote (("TODO" :foreground "red" :weight bold)
+                ("NEXT" :foreground "cyan" :weight bold)
+                ("DOING" :foreground "orchid" :weight bold)
+                ("DONE" :foreground "forest green" :weight bold)
+                ("WAITING" :foreground "orange" :weight bold)
+                ("HOLD" :foreground "magenta" :weight bold)
+                ("CANCELLED" :foreground "forest green" :weight bold))))
+
+                ;; tag stuff automatically dependent on a change of state
+                (setq org-todo-state-tags-triggers
+                (quote (("CANCELLED" ("CANCELLED" . t))
+                ("WAITING" ("WAITING" . t))
+                ("HOLD" ("WAITING") ("HOLD" . t))
+                (done ("WAITING") ("HOLD"))
+                ("TODO" ("WAITING") ("CANCELLED") ("HOLD"))
+                ("NEXT" ("WAITING") ("CANCELLED") ("HOLD"))
+                ("DONE" ("WAITING") ("CANCELLED") ("HOLD")))))
+
+                ;; Get more priority options
+                (setq org-highest-priority ?A)
+                (setq org-default-priority ?C)
+                (setq org-lowest-priority ?E)
+
+                (setq org-priority-faces
+                '((?A . (:foreground "#CC0000" :background "#FFE3E3"))
+                (?B . (:foreground "#64992C" :background "#EBF4DD"))
+                (?C . (:foreground "#64992C" :background "#FFFFFF"))))
+                (setq org-ellipsis "...")
+  )
+
+
+
+
+
+
+
+;; Whenever you reconfigure a package, make sure to wrap your config in an
+;; `after!' block, otherwise Doom's defaults may override your settings. E.g.
+;;
+;;   (after! PACKAGE
+;;     (setq x y))
+;;
+;; The exceptions to this rule:
+;;
+;;   - Setting file/directory variables (like `org-directory')
+;;   - Setting variables which explicitly tell you to set them before their
+;;     package is loaded (see 'C-h v VARIABLE' to look up their documentation).
+;;   - Setting doom variables (which start with 'doom-' or '+').
+;;
+;; Here are some additional functions/macros that will help you configure Doom.
+;;
+;; - `load!' for loading external *.el files relative to this one
+;; - `use-package!' for configuring packages
+;; - `after!' for running code after a package has loaded
+;; - `add-load-path!' for adding directories to the `load-path', relative to
+;;   this file. Emacs searches the `load-path' when you load packages with
+;;   `require' or `use-package'.
+;; - `map!' for binding new keys
+;;
+;; To get information about any of these functions/macros, move the cursor over
+;; the highlighted symbol at press 'K' (non-evil users must press 'C-c c k').
+;; This will open documentation for it, including demos of how they are used.
+;; Alternatively, use `C-h o' to look up a symbol (functions, variables, faces,
+;; etc).
+;;
+;; You can also try 'gd' (or 'C-c c d') to jump to their definition and see how
+;; they are implemented.
diff --git a/doom.d/init.el b/doom.d/init.el
new file mode 100644
index 0000000..db4c865
--- /dev/null
+++ b/doom.d/init.el
@@ -0,0 +1,194 @@
+;;; init.el -*- lexical-binding: t; -*-
+
+;; This file controls what Doom modules are enabled and what order they load
+;; in. Remember to run 'doom sync' after modifying it!
+
+;; NOTE Press 'SPC h d h' (or 'C-h d h' for non-vim users) to access Doom's
+;;      documentation. There you'll find a link to Doom's Module Index where all
+;;      of our modules are listed, including what flags they support.
+
+;; NOTE Move your cursor over a module's name (or its flags) and press 'K' (or
+;;      'C-c c k' for non-vim users) to view its documentation. This works on
+;;      flags as well (those symbols that start with a plus).
+;;
+;;      Alternatively, press 'gd' (or 'C-c c d') on a module to browse its
+;;      directory (for easy access to its source code).
+
+(doom! :input
+       ;;bidi              ; (tfel ot) thgir etirw uoy gnipleh
+       ;;chinese
+       ;;japanese
+       ;;layout            ; auie,ctsrnm is the superior home row
+
+       :completion
+       company           ; the ultimate code completion backend
+       ;;helm              ; the *other* search engine for love and life
+       ;;ido               ; the other *other* search engine...
+       ;;ivy               ; a search engine for love and life
+       vertico           ; the search engine of the future
+
+       :ui
+       ;;deft              ; notational velocity for Emacs
+       doom              ; what makes DOOM look the way it does
+       doom-dashboard    ; a nifty splash screen for Emacs
+       ;;doom-quit         ; DOOM quit-message prompts when you quit Emacs
+       ;;(emoji +unicode)  ; 🙂
+       hl-todo           ; highlight TODO/FIXME/NOTE/DEPRECATED/HACK/REVIEW
+       ;;hydra
+       ;;indent-guides     ; highlighted indent columns
+       ;;ligatures         ; ligatures and symbols to make your code pretty again
+       ;;minimap           ; show a map of the code on the side
+       modeline          ; snazzy, Atom-inspired modeline, plus API
+       ;;nav-flash         ; blink cursor line after big motions
+       ;;neotree           ; a project drawer, like NERDTree for vim
+       ophints           ; highlight the region an operation acts on
+       (popup +defaults)   ; tame sudden yet inevitable temporary windows
+       ;;tabs              ; a tab bar for Emacs
+       ;;treemacs          ; a project drawer, like neotree but cooler
+       ;;unicode           ; extended unicode support for various languages
+       (vc-gutter +pretty) ; vcs diff in the fringe
+       vi-tilde-fringe   ; fringe tildes to mark beyond EOB
+       ;;window-select     ; visually switch windows
+       workspaces        ; tab emulation, persistence & separate workspaces
+       ;;zen               ; distraction-free coding or writing
+
+       :editor
+       (evil +everywhere); come to the dark side, we have cookies
+       file-templates    ; auto-snippets for empty files
+       fold              ; (nigh) universal code folding
+       ;;(format +onsave)  ; automated prettiness
+       ;;god               ; run Emacs commands without modifier keys
+       ;;lispy             ; vim for lisp, for people who don't like vim
+       ;;multiple-cursors  ; editing in many places at once
+       ;;objed             ; text object editing for the innocent
+       ;;parinfer          ; turn lisp into python, sort of
+       ;;rotate-text       ; cycle region at point between text candidates
+       snippets          ; my elves. They type so I don't have to
+       ;;word-wrap         ; soft wrapping with language-aware indent
+
+       :emacs
+       dired             ; making dired pretty [functional]
+       electric          ; smarter, keyword-based electric-indent
+       ;;ibuffer         ; interactive buffer management
+       undo              ; persistent, smarter undo for your inevitable mistakes
+       vc                ; version-control and Emacs, sitting in a tree
+
+       :term
+       ;;eshell            ; the elisp shell that works everywhere
+       ;;shell             ; simple shell REPL for Emacs
+       ;;term              ; basic terminal emulator for Emacs
+       vterm             ; the best terminal emulation in Emacs
+
+       :checkers
+       syntax              ; tasing you for every semicolon you forget
+       ;;(spell +flyspell) ; tasing you for misspelling mispelling
+       ;;grammar           ; tasing grammar mistake every you make
+
+       :tools
+       ;;ansible
+       ;;biblio            ; Writes a PhD for you (citation needed)
+       ;;debugger          ; FIXME stepping through code, to help you add bugs
+       ;;direnv
+       ;;docker
+       ;;editorconfig      ; let someone else argue about tabs vs spaces
+       ;;ein               ; tame Jupyter notebooks with emacs
+       (eval +overlay)     ; run code, run (also, repls)
+       ;;gist              ; interacting with github gists
+       lookup              ; navigate your code and its documentation
+       ;;lsp               ; M-x vscode
+       magit             ; a git porcelain for Emacs
+       ;;make              ; run make tasks from Emacs
+       pass              ; password manager for nerds
+       ;;pdf               ; pdf enhancements
+       ;;prodigy           ; FIXME managing external services & code builders
+       ;;rgb               ; creating color strings
+       ;;taskrunner        ; taskrunner for all your projects
+       ;;terraform         ; infrastructure as code
+       ;;tmux              ; an API for interacting with tmux
+       ;;tree-sitter       ; syntax and parsing, sitting in a tree...
+       ;;upload            ; map local to remote projects via ssh/ftp
+
+       :os
+       (:if IS-MAC macos)  ; improve compatibility with macOS
+       ;;tty               ; improve the terminal Emacs experience
+
+       :lang
+       ;;agda              ; types of types of types of types...
+       ;;beancount         ; mind the GAAP
+       ;;(cc +lsp)         ; C > C++ == 1
+       ;;clojure           ; java with a lisp
+       ;;common-lisp       ; if you've seen one lisp, you've seen them all
+       ;;coq               ; proofs-as-programs
+       ;;crystal           ; ruby at the speed of c
+       ;;csharp            ; unity, .NET, and mono shenanigans
+       ;;data              ; config/data formats
+       ;;(dart +flutter)   ; paint ui and not much else
+       ;;dhall
+       ;;elixir            ; erlang done right
+       ;;elm               ; care for a cup of TEA?
+       emacs-lisp        ; drown in parentheses
+       ;;erlang            ; an elegant language for a more civilized age
+       ;;ess               ; emacs speaks statistics
+       ;;factor
+       ;;faust             ; dsp, but you get to keep your soul
+       ;;fortran           ; in FORTRAN, GOD is REAL (unless declared INTEGER)
+       ;;fsharp            ; ML stands for Microsoft's Language
+       ;;fstar             ; (dependent) types and (monadic) effects and Z3
+       ;;gdscript          ; the language you waited for
+       ;;(go +lsp)         ; the hipster dialect
+       ;;(graphql +lsp)    ; Give queries a REST
+       ;;(haskell +lsp)    ; a language that's lazier than I am
+       ;;hy                ; readability of scheme w/ speed of python
+       ;;idris             ; a language you can depend on
+       ;;json              ; At least it ain't XML
+       ;;(java +lsp)       ; the poster child for carpal tunnel syndrome
+       ;;javascript        ; all(hope(abandon(ye(who(enter(here))))))
+       ;;julia             ; a better, faster MATLAB
+       ;;kotlin            ; a better, slicker Java(Script)
+       ;;latex             ; writing papers in Emacs has never been so fun
+       ;;lean              ; for folks with too much to prove
+       ;;ledger            ; be audit you can be
+       ;;lua               ; one-based indices? one-based indices
+       markdown          ; writing docs for people to ignore
+       ;;nim               ; python + lisp at the speed of c
+       ;;nix               ; I hereby declare "nix geht mehr!"
+       ;;ocaml             ; an objective camel
+       org               ; organize your plain life in plain text
+       ;;php               ; perl's insecure younger brother
+       ;;plantuml          ; diagrams for confusing people more
+       ;;purescript        ; javascript, but functional
+       ;;python            ; beautiful is better than ugly
+       ;;qt                ; the 'cutest' gui framework ever
+       ;;racket            ; a DSL for DSLs
+       ;;raku              ; the artist formerly known as perl6
+       ;;rest              ; Emacs as a REST client
+       ;;rst               ; ReST in peace
+       ;;(ruby +rails)     ; 1.step {|i| p "Ruby is #{i.even? ? 'love' : 'life'}"}
+       ;;(rust +lsp)       ; Fe2O3.unwrap().unwrap().unwrap().unwrap()
+       ;;scala             ; java, but good
+       ;;(scheme +guile)   ; a fully conniving family of lisps
+       sh                ; she sells {ba,z,fi}sh shells on the C xor
+       ;;sml
+       ;;solidity          ; do you need a blockchain? No.
+       ;;swift             ; who asked for emoji variables?
+       ;;terra             ; Earth and Moon in alignment for performance.
+       ;;web               ; the tubes
+       ;;yaml              ; JSON, but readable
+       ;;zig               ; C, but simpler
+
+       :email
+       ;;(mu4e +org +gmail)
+       ;;notmuch
+       ;;(wanderlust +gmail)
+
+       :app
+       ;;calendar
+       ;;emms
+       ;;everywhere        ; *leave* Emacs!? You must be joking
+       ;;irc               ; how neckbeards socialize
+       ;;(rss +org)        ; emacs as an RSS reader
+       ;;twitter           ; twitter client https://twitter.com/vnought
+
+       :config
+       ;;literate
+       (default +bindings +smartparens))
diff --git a/doom.d/packages.el b/doom.d/packages.el
new file mode 100644
index 0000000..edf4a1b
--- /dev/null
+++ b/doom.d/packages.el
@@ -0,0 +1,52 @@
+;; -*- no-byte-compile: t; -*-
+;;; $DOOMDIR/packages.el
+
+;; To install a package with Doom you must declare them here and run 'doom sync'
+;; on the command line, then restart Emacs for the changes to take effect -- or
+;; use 'M-x doom/reload'.
+
+
+;; To install SOME-PACKAGE from MELPA, ELPA or emacsmirror:
+;(package! some-package)
+
+;; To install a package directly from a remote git repo, you must specify a
+;; `:recipe'. You'll find documentation on what `:recipe' accepts here:
+;; https://github.com/radian-software/straight.el#the-recipe-format
+;(package! another-package
+;  :recipe (:host github :repo "username/repo"))
+
+;; If the package you are trying to install does not contain a PACKAGENAME.el
+;; file, or is located in a subdirectory of the repo, you'll need to specify
+;; `:files' in the `:recipe':
+;(package! this-package
+;  :recipe (:host github :repo "username/repo"
+;           :files ("some-file.el" "src/lisp/*.el")))
+
+;; If you'd like to disable a package included with Doom, you can do so here
+;; with the `:disable' property:
+;(package! builtin-package :disable t)
+
+;; You can override the recipe of a built in package without having to specify
+;; all the properties for `:recipe'. These will inherit the rest of its recipe
+;; from Doom or MELPA/ELPA/Emacsmirror:
+;(package! builtin-package :recipe (:nonrecursive t))
+;(package! builtin-package-2 :recipe (:repo "myfork/package"))
+
+;; Specify a `:branch' to install a package from a particular branch or tag.
+;; This is required for some packages whose default branch isn't 'master' (which
+;; our package manager can't deal with; see radian-software/straight.el#279)
+;(package! builtin-package :recipe (:branch "develop"))
+
+;; Use `:pin' to specify a particular commit to install.
+;(package! builtin-package :pin "1a2b3c4d5e")
+
+
+;; Doom's packages are pinned to a specific commit and updated from release to
+;; release. The `unpin!' macro allows you to unpin single packages...
+;(unpin! pinned-package)
+;; ...or multiple packages
+;(unpin! pinned-package another-pinned-package)
+;; ...Or *all* packages (NOT RECOMMENDED; will likely break things)
+;(unpin! t)
+
+(package! tldr)