aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBozhidar Batsov <bozhidar@batsov.com>2020-11-25 14:25:05 +0200
committerBozhidar Batsov <bozhidar@batsov.com>2020-11-25 14:25:30 +0200
commitb7af611000c6e949fdb1190d3844e3feccddc04e (patch)
tree4918260f2c9888dfbe1754833368231b3b9d8eba /doc
parentc2acfcbd04a5cfafadb86e5c00ed275f516ac6e2 (diff)
[Docs] Document the changes introduced in #1535
Diffstat (limited to 'doc')
-rw-r--r--doc/modules/ROOT/pages/configuration.adoc24
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/modules/ROOT/pages/configuration.adoc b/doc/modules/ROOT/pages/configuration.adoc
index 0a30b3a..1a06a5d 100644
--- a/doc/modules/ROOT/pages/configuration.adoc
+++ b/doc/modules/ROOT/pages/configuration.adoc
@@ -298,6 +298,30 @@ want to set
in order to allow for the occasions where you want to select the
top-level directory.
+=== Project-specific Compilation Buffers
+
+This affects all commands built on top of `projectile--run-project-cmd` like:
+
+- `projectile-configure-project`
+- `projectile-run-project`
+- `projectile-test-project`
+- `projectile-install-project`
+- `projectile-package-project`
+
+Normally, the buffers created by those commands would be shared (overwritten)
+between projects, but it's also possible to make the compilation buffer names
+project-specific. Currently, this requires that the user explicitly set:
+
+[source,elisp]
+----
+(setq compilation-buffer-name-function
+ #'projectile-compilation-buffer-name)
+(setq compilation-save-buffers-predicate
+ #'projectile-current-project-buffer-p)
+----
+
+Both of these degrade properly when not inside a project.
+
== Completion Options
=== Auto (default)