aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--doom.d/config.el304
-rw-r--r--doom.d/init.el194
-rw-r--r--doom.d/packages.el52
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)