Henrik Lissner
6f40ad55f5
docs: discourage after! and use-package! use
...
There's little reason for users to use these macros in their private
configs over plain ol' `with-eval-after-load` and `use-package`, unless
they're writing their own modules.
It's my fault for signal boosting them in documentation and whenever I'm
asked for help, because beginners now believe they are somehow
required for Doom to work correctly (there are guides out there
telling beginners that migrating to Doom involves replacing all
instances of `with-eval-after-load` and `use-package` in their
pre-existing configs with `after!` and `use-package!` -- which was never
true).
What's more, I plan to replace `use-package`, internally, so the
`use-package!` macro won't exist for much longer.
2026-02-09 04:29:47 -05:00
Henrik Lissner
cff091982e
fix(cli): rewrite 'doom sync'; deprecate 'doom build'
...
This changes 'doom sync' to be smarter about responding to changed
package recipes/pins, changes in Emacs version, or instances where the user
has copied a config to a new system.
In all these cases, the user would formerly have to know about a
specific combination of 'doom sync -u' and 'doom build' to ensure Doom
is in a good state. With this change, 'doom sync' handles all these
cases.
Also, 'doom build' is now deprecated (and 'doom sync' now has a
--rebuild option to mimic its old behavior).
Also also, sometimes, a package may silently fail when cloned (which
used to result in an empty repo). Now, if this is detected, cloning will
be re-attempted up to 3 times before aborting with much more visible
error.
Note: these are stopgap solutions, until v3 is finished.
2024-03-24 18:03:12 -04:00
Liam Hupfer
37affa5cff
feat: add doom-emoji-font
...
This parallels doom-symbol-font for emoji. In the process, refactor
symbol and emoji font setup to take advantage of these parallels.
2023-10-07 02:33:45 +02:00
Liam Hupfer
4499ce7b0a
refactor: doom-unicode-font -> doom-symbol-font
...
No font supports all of Unicode or anywhere near it. It’s not even
really possible with current font formats. Therefore, rename
`doom-unicode-font` to `doom-symbol-font`. Only set it as a fallback for
characters in the `symbol` and `mathematical` scripts.
2023-10-07 02:33:45 +02:00
Liam Hupfer
1cc7b04059
docs: clarify doom-unicode-font default
...
d4dec35658 removed Apple Color Emoji, and it wasn’t clear how Symbola
was set if this variable was nil.
2023-10-07 02:33:45 +02:00
Henrik Lissner
88bb045388
docs(*): replace all-the-icons with nerd-icons
...
Also colorizes the leading icon in notices.
2023-09-16 20:19:11 +02:00
TEC
5ac2a5258b
docs: change link format
2022-10-05 01:01:19 +02:00
Henrik Lissner
1abcf913aa
revert: fix(docs): set mode in file-local vars
...
emacs-straight/org-mode@e22b4eb7aa introduced a breaking change that
made it impossible to rely on .dir-locals.el to change org-mode buffers
in $EMACSDIR to doom-docs-org-mode (without infinite recursion), so we
used file-local variables in 7e400ab .
emacs-straight/org-mode@215de6176b reverted that change, so we can use
.dir-locals.el again, and this is my preference, since it requires less
boilerplate across our hundreds of org files.
Ref: emacs-straight/org-mode@215de6176b
Ref: emacs-straight/org-mode@e22b4eb7aa
Revert: 7e400abdc0
2022-08-07 19:08:07 +02:00
Henrik Lissner
0cee8b4bee
docs: rewrite faq.org
2022-08-04 01:29:36 +02:00
Henrik Lissner
43ddb10970
docs/faq: fix evil-snipe instructions
...
Fixes #5242
2021-07-07 11:43:50 -04:00
Henrik Lissner
473417a890
docs/faq: fix discourse notice
2021-04-18 22:25:45 -04:00
Henrik Lissner
e46736e44d
Deprecate docs/faq.org
2021-04-14 23:43:45 -04:00
Henrik Lissner
028c682047
Merge pull request #3906 from Jonta/patch-1
...
Larger link. Fitt's law
2020-10-05 21:06:11 -04:00
yanekm
19811b1dce
minor fixes ( #3957 )
...
* minor typo fixes
* Refill corrected paragraph
Co-authored-by: Henrik Lissner <accounts@v0.io>
2020-10-04 16:34:54 -04:00
Jonta
273b5370a5
Larger link. Fitt's law
...
Works grammatically too
2020-09-07 13:53:04 +02:00
Tom Fryers
791ab1a1db
Fix typo in faq.org
2020-08-27 06:44:14 +01:00
Henrik Lissner
98283d302b
docs/faq: minor corrections
2020-08-24 23:00:32 -04:00
Henrik Lissner
7081d833f6
Move :ui pretty-code to :ui ligatures
...
Includes a major refactor of the module.
2020-08-20 02:14:32 -04:00
Henrik Lissner
73cb463bdf
doc/faq: expand on "which terminal should I use?"
2020-08-07 20:15:14 -04:00
Henrik Lissner
8dfe8840a6
docs/faq: add "My keybinds don't work"
2020-07-26 18:50:16 -04:00
Henrik Lissner
807eb82bde
docs/faq: add "How to make a new theme"
2020-07-25 02:22:41 -04:00
Henrik Lissner
d2117b7879
docs/faq: add "How to share/sync config between computers"
2020-07-24 01:49:58 -04:00
Henrik Lissner
2bb88e24d4
docs/faq: Add "~/.emacs.d/server is unsafe" error
2020-07-24 01:28:06 -04:00
Henrik Lissner
cd40d45cec
docs/faq: minor corrections & revision
2020-07-24 00:41:39 -04:00
Henrik Lissner
e6221844fd
docs/faq: general revision & reformatting
2020-07-23 21:45:54 -04:00
Henrik Lissner
f99c3fb3a0
docs/faq: "Why is scrolling slow"->"Why is Emacs slow"
...
Expand on this question and mention Emacs 27 and gccemacs as solution.
2020-07-23 21:45:53 -04:00
Henrik Lissner
1e0cd6ddce
docs/faq: add "Is Doom a fork of spacemacs/prelude/etc?"
2020-07-23 21:45:53 -04:00
Henrik Lissner
0ebb5cf35d
docs/faq: add "Why sharp-quote functions"
2020-07-23 21:45:53 -04:00
Henrik Lissner
316a9b871b
docs/faq: add "How to maximize/fullscreen at startup"
2020-07-23 21:45:50 -04:00
Henrik Lissner
d70b2ff776
docs/faq: add "How to disable smartparens" #3609
2020-07-23 19:11:50 -04:00
Henrik Lissner
7e621e3787
Remove org-hide-leading-stars-before-indent-mode #3076
...
Org no longer uses this variable.
2020-05-10 05:22:02 -04:00
Henrik Lissner
022564f737
Update ToC in FAQ
2020-05-08 15:21:30 -04:00
Henrik Lissner
692772a9bd
Add "Why is scrolling slow in Emacs/Doom?" to FAQ
2020-05-08 15:08:25 -04:00
Henrik Lissner
7bb9a8ffa1
Revise docs/faq
2020-05-08 15:08:25 -04:00
Henrik Lissner
1e3a97d11b
docs/faq: minor revision & reformatting
2020-04-15 14:11:41 -04:00
Henrik Lissner
333257b45f
Clarify "Which terminal should I use?" in faq
2020-04-15 14:09:24 -04:00
Henrik Lissner
963d3695b9
Clarify "How do I customize a theme or face(s)" in faq
2020-04-15 00:13:34 -04:00
Henrik Lissner
187ba0f66f
Mention how to enable LSP manually
...
For major modes whose :lang modules lack an +lsp flag.
2020-04-13 18:45:39 -04:00
Henrik Lissner
fc32a4c41c
Add "What terminal should I use?" to faq
2020-04-13 18:45:39 -04:00
Henrik Lissner
3f4482a225
Update FAQ
...
Add a few questions, remove obsolete ones, and revise the rest.
2020-04-08 23:13:43 -04:00
Henrik Lissner
8ab0cd66a7
Replace undo-tree with undo-fu + undo-fu-session
...
Despite the recent patches to fix undo history corruption, its history
would still get unpredictably truncated due to non-linear memory
expansion.
Relevant to #2339
2020-04-07 20:15:53 -04:00
Henrik Lissner
854adcd3a9
Merge pull request #2747 from lukeberry99/patch-1
...
Update faq.org
2020-03-27 01:56:00 -04:00
Nadav Cohen
1d50451e08
Fixed typo in faq.org
2020-03-25 11:19:37 -07:00
Luke Berry
f4ef6205cd
Update faq.org
...
Minor grammatical fix in an otherwise fantastic faq
2020-03-20 15:34:32 +00:00
Henrik Lissner
dd402b7db3
Remove references to enh-ruby-mode
2020-03-12 11:29:54 -04:00
Christopher League
776c010cb5
Fix internal documentation links containing "%20"
...
These links to org headers didn't work for me when they contain %20
instead of space.
2020-03-09 15:31:57 -04:00
Henrik Lissner
665b627b7c
Update & revise docs
...
+ Getting Started
+ Add "Using/loading local packages" section
+ Add "Pinning packages to specific commits" section
+ Clarify prereqs & revise install docs
+ Revise package-management section
+ FAQ
+ Add package management section
2020-01-28 05:36:42 -05:00
Henrik Lissner
9fa78f6a64
Update discord link again
...
First link wasn't a permanent link. Whoops!
2020-01-27 23:58:32 -05:00
Henrik Lissner
d27ff78444
Update discord links
2020-01-27 23:36:39 -05:00
Henrik Lissner
6cdc060432
Update & revise docs/faq.org
2020-01-26 04:19:39 -05:00