Zengtudor/ccls
1
0
Fork 0
mirror of https://github.com/MaskRay/ccls.git synced 2024-11-22 07:35:08 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

More about clang.pathMappings

Fangrui Song 2019-03-23 08:34:42 -07:00
parent 46bfd9470c
commit f007debed4
2 changed files with 14 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
Customization.md

@ -101,26 +101,28 @@ Example: `{"clang": {"excludeArgs": ["-frounding-math"]}}`
Default: _empty_ Default: _empty_
A list of `<src>:<dest>` path conversions used to remap the paths of files in A list of `src>dest` path conversions used to remap the paths of files in
the project. This can be used to move a project to a new location without the project. This can be used to move a project to a new location without
re-indexing. re-indexing.
If cache files were built with project root `/tmp/container/proj`, and you If cache files were built with project root `/tmp/remote/proj`, and you
want to reuse them with a different project root `/tmp/host/proj` then copy the want to reuse them with a different project root `/tmp/host/proj` then copy the
cache: cache:
```sh ```sh
rsync -a /tmp/ccls/@tmp@container@proj/ /tmp/ccls/@tmp@host@proj/ # files under project root rsync -a /tmp/ccls/@tmp@remote@proj/ /tmp/ccls/@tmp@host@proj/ # files under project root
rsync -a /tmp/ccls/@@tmp@container@proj/ /tmp/ccls/@@tmp@host@proj/ # files outside of project root rsync -a /tmp/ccls/@@tmp@remote@proj/ /tmp/ccls/@@tmp@host@proj/ # files outside of project root
``` ```
Then use the initialization option `{"clang": {"pathMappings": Then use the initialization option
["/container/:/host/"]}` ```javascript
{"clang": {"pathMappings": ["/remote/>/host/"]}
```
When `ccls` indexes `/tmp/host/proj/a.cc`, the cache file When ccls indexes `/tmp/host/proj/a.cc`, the cache file
`/tmp/ccls/@tmp@host@proj/a.cc.blob` will be reused. When `a.cc` is saved `/tmp/ccls/@tmp@remote@proj/a.cc.blob` will be reused. When `a.cc` is saved
(re-indexed), the newly generated `a.cc.blob` will not contain (re-indexed), the newly generated `a.cc.blob` will not contain
`/tmp/container` paths any more. `/tmp/remote` paths any more.
#### `cache.retainInMemory` #### `cache.retainInMemory`

3
FAQ.md

@ -49,6 +49,9 @@ indexing.
files as you open them, by setting `index.initialBlacklist` to `["."]` (a files as you open them, by setting `index.initialBlacklist` to `["."]` (a
regular expression that will match every file). regular expression that will match every file).
* You can copy `.ccls-cache` built from a more powerful machine.
See [`clang.pathMappings`](Customization#clangpathMappings).
Note that when you edit a header file, `ccls` will automatically open the Note that when you edit a header file, `ccls` will automatically open the
associated (by name) source file if one exists, and index it as well to locate associated (by name) source file if one exists, and index it as well to locate
definitions of symbols declared in the header file. For example, if you edit definitions of symbols declared in the header file. For example, if you edit