From 5d8d417ba80b6159790d0c5ef3c7bbfd89e1d11b Mon Sep 17 00:00:00 2001 From: Sebastian Pfitzner Date: Sun, 7 Nov 2021 21:17:01 +0100 Subject: [PATCH] faq section --- docs/make.jl | 1 + docs/src/faq.md | 14 ++++++++++++++ docs/src/images/precompile-failure.png | Bin 0 -> 11108 bytes 3 files changed, 15 insertions(+) create mode 100644 docs/src/faq.md create mode 100644 docs/src/images/precompile-failure.png diff --git a/docs/make.jl b/docs/make.jl index 9b0da48..fbfd2d7 100644 --- a/docs/make.jl +++ b/docs/make.jl @@ -9,6 +9,7 @@ makedocs( "Home" => "index.md", # "Setup" => "setup.md", "Getting Started" => "gettingstarted.md", + "FAQ" => "faq.md", "User Guide" => Any[ "Running Code" => "userguide/runningcode.md", "Julia Environments" => "userguide/env.md", diff --git a/docs/src/faq.md b/docs/src/faq.md new file mode 100644 index 0000000..b02ac05 --- /dev/null +++ b/docs/src/faq.md @@ -0,0 +1,14 @@ +# Frequently Asked Questions + +### The language server fails to precompile. What can I do about that? +You've probably been directed here by a pop-up like the following +![LS precompilation failure](./images/precompile-failure.png) + +Click the `Open Logs` button or go to `Output` > `Julia Language Server`. You should see a message like this, among others: +``` +The Language Server failed to precompile. +Please make sure you have permissions to write to the LS depot path at + /home/pfitzseb/.config/Code/User/globalStorage/julialang.language-julia/lsdepot/v1 +``` + +Your current account needs to have read/write access to the indicated directory. Also make sure that it isn't on a NFS volume or similar, as that may cause issues. diff --git a/docs/src/images/precompile-failure.png b/docs/src/images/precompile-failure.png new file mode 100644 index 0000000000000000000000000000000000000000..464a3621ec320feeaf650f8a49ed3664dd118169 GIT binary patch literal 11108 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 literal 0 HcmV?d00001