nvim_doom_config/.gitignore

# My temp files
time_cost.txt
tags
# Backup files
.doom_releases
.doom_backup_hash
# editor artifacts
*~
*.swp
# OS files
.DS_Store
# Doom Nvim Contrib files
contribute/doom-nvim-contrib
contribute/local-share-nvim
contribute/workspace

# User modules
user/modules/*
# Editor files
.luarc.json
Version 2.0.0, Lua migration (#4) See CHANGELOG.md 4 years ago			`# My temp files`
docs: update docs and gitignore 3 years ago			`time_cost.txt`
feat: added a ton of new features and cool plugins (#88) Co-authored-by: Alejandro <bloodbathalchemist@protonmail.com> 3 years ago			`tags`
feat: ignore update files 3 years ago			`# Backup files`
			`.doom_releases`
			`.doom_backup_hash`
feat(gitignore): ignore editor artifacts (#141) 3 years ago			`# editor artifacts`
			`*~`
			`*.swp`
Added development docker image and bootstrap script 3 years ago			`# OS files`
			`.DS_Store`
			`# Doom Nvim Contrib files`
Let doom-nvim bootstrap docker 3 years ago			`contribute/doom-nvim-contrib`
			`contribute/local-share-nvim`
			`contribute/workspace`
feat: Documented custom module tutorial + example. 3 years ago
			`# User modules`
			`user/modules/*`
feat(modules): make modules very granular These changes have been discussed in #233. As a side note, I ran stylua and luacheck over the repo. * From everyone's perpective - The module structure has been flattened out, removing the category grouping. Beyond less iteration scopes, this may help with, in the future, allowing the user to write and enable custom modules in $DOOMDIR. * From the user's perpective - `doom_config.lua` works via overrides now, it can change defaults on the global `doom` before everything gets actually configured. - `doom_modules.lua` just returns the actual thing it's supposed to, without {return value}.source. More on that next. - Instead of each config file returning a source key with its file location, the handlers for each config file actively search for them. This is described in the respective files inside `lua/doom/core/config`, but it's basicaly a check for two special paths falling back to runtimepath. - `doom_userplugins.lua` is removed in favor of having its functionality in `doom_config.lua`. To add a standalone package, add its packer spec to `doom.packages` (this is a map-like table of package names to packer specs). - To override the spec of a module package, change the keys in `doom.packages[package_name_without_author]`. Special attrs: `config` is run after the built-in config. - To change settings and behavior, override keys in `doom[module]`, or just `doom.` for some core features. - To add standalone bindings, add them to `doom.binds`. This is passed to nest along with the modules' binds. `doom.binds` overrides anything you don't like in modules, you can safely replace the bind. - To add standalone autocmds, add them to `doom.autocmds[augroup_name]`. The structure is as passed to `utils.create_augroups`, so: ```lua doom.autocmds[group_name] = { { event1, pattern1, cmd1 }, ... } ``` - You shouldn't override any tables, like `doom.autocmds` or `doom.packages`, only the leaves, else you remove all that is already there. We could use metatables to avoid this in the future. - The `config.nvim` table is no longer used, most of its functionality is spread elsewhere, like autocmds. For variables and options, just use vim.opt., vim.g.* etc. in `doom_config.lua` - Settings can also be appended to in `doom_config.lua`, because defaults are prepopulated. * From a maintainer's perpective - Most things are grouped under the `doom` global, which is populated and overriden early in `init.lua`. The exception is enabled modules, which you still need to require `doom.core.config.modules` to get. However, do so sparingly, and only if you truly mean to iterate over enabled modules disregarding user overrides (they may have removed a particular package or reset binds). - Modules are defined in the following folder structure inside `lua/doom/modules`: `<module>/{init.lua,packages.lua,binds.lua,autocmds.lua}`. init.lua and packages.lua are required, even if empty. - `init.lua` returns: defaults under a `defaults` key; config functions under `packer_config[package_name]`. It can access the doom global only inside the configs. - `packages.lua` returns: a map of package names to package specs, with no `config` or `disable` keys present. Most things should be lazy-loaded, preferably with the `cmd` and `module` keys. It cannot access the doom global. - `autocmds.lua` returns: a list of autocmds to be applied under the group `doom_{module}`. It can use the `doom` global to add things conditionally. - `binds.lua` returns: the keyconfig to be passed to nest. It can use the `doom` global to add things conditionally. What's left: - Implement lsp wrapping. - Document the individual modules. - Write a migration script. 3 years ago			`# Editor files`
			`.luarc.json`