emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Clarify how projectile resolves project roots

Browse source
This commit is contained in:
Henrik Lissner 2020-04-07 22:32:52 -04:00
parent ccd282b28c
commit 011bbff7af
No known key found for this signature in database
GPG key ID: 5F6C0EA160557395
1 changed files with 12 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

24
core/core-projects.el
View file

@ -45,18 +45,18 @@ Emacs.")
;; Projectile runs four functions to determine the root (in this order): ;; Projectile runs four functions to determine the root (in this order):
;; ;;
;; + `projectile-root-local' -> consults the `projectile-project-root' ;; + `projectile-root-local' -> checks the `projectile-project-root' variable
;; variable for an explicit path. ;; for an explicit path.
;; + `projectile-root-bottom-up' -> consults ;; + `projectile-root-bottom-up' -> searches from / to your current directory
;; `projectile-project-root-files-bottom-up'; searches from / to your ;; for the paths listed in `projectile-project-root-files-bottom-up'. This
;; current directory for certain files (including .project and .git) ;; includes .git and .project
;; + `projectile-root-top-down' -> consults `projectile-project-root-files'; ;; + `projectile-root-top-down' -> searches from the current directory down to
;; searches from the current directory down to / for certain project ;; / the paths listed in `projectile-root-top-down-recurring', like
;; markers, like package.json, setup.py, or Cargo.toml ;; package.json, setup.py, or Cargo.toml
;; + `projectile-root-top-down-recurring' -> consults ;; + `projectile-root-top-down-recurring' -> searches from the current
;; `projectile-project-root-files-top-down-recurring'; e.g. searches from ;; directory down to / for a directory that has one of
;; the current directory down to / for a directory that has Makefile but ;; `projectile-project-root-files-top-down-recurring' but doesn't have a
;; doesn't have a parent with one of those files. ;; parent directory with the same file.
;; ;;
;; In the interest of performance, we reduce the number of project root marker ;; In the interest of performance, we reduce the number of project root marker
;; files/directories projectile searches for when resolving the project root. ;; files/directories projectile searches for when resolving the project root.