Auto merge of #2083 - puremourning:readme-pyenv, r=vheon
Add how to build python to avoid startup problems (in particular, pyenv) # PR Prelude Thank you for working on YCM! :) **Please complete these steps and check these boxes (by putting an `x` inside the brackets) _before_ filing your PR:** - [X] I have read and understood YCM's [CONTRIBUTING][cont] document. - [X] I have read and understood YCM's [CODE_OF_CONDUCT][code] document. - [X] I have included tests for the changes in my PR. If not, I have included a rationale for why I haven't. - [X] **I understand my PR may be closed if it becomes obvious I didn't actually perform all of these steps.** # Why this change is necessary and useful I spent a while trying to find where I had written the instructions for building python with pyenv to work with YCM, then I thought the README was a good place for it. ycmd must use pythons with `--enable-shared` or `--enable-framework` else boom. [cont]: https://github.com/Valloric/YouCompleteMe/blob/master/CONTRIBUTING.md [code]: https://github.com/Valloric/YouCompleteMe/blob/master/CODE_OF_CONDUCT.md <!-- Reviewable:start --> --- This change is [<img src="https://reviewable.io/review_button.svg" height="35" align="absmiddle" alt="Reviewable"/>](https://reviewable.io/reviews/valloric/youcompleteme/2083) <!-- Reviewable:end -->
This commit is contained in:
Homu
commit
1b76af4386
23
README.md
23
README.md
@ -2531,6 +2531,29 @@ CompileCommands API) were added after their cut.
|
|||||||
So just go through the installation guide and make sure you are using a correct
|
So just go through the installation guide and make sure you are using a correct
|
||||||
`libclang.so`. I recommend downloading prebuilt binaries from llvm.org.
|
`libclang.so`. I recommend downloading prebuilt binaries from llvm.org.
|
||||||
|
|
||||||
|
|
||||||
|
### I get `Fatal Python error: PyThreadState_Get: no current thread` on startup
|
||||||
|
|
||||||
|
This is caused by linking a static version of `libpython` into ycmd's
|
||||||
|
`ycm_core.so`. This leads to multiple copies of the python interpreter loaded
|
||||||
|
when `python` loads `ycmd_core.so` and this messes up python's global state.
|
||||||
|
The details aren't important.
|
||||||
|
|
||||||
|
The solution is that the version of Python linked and run against must be built
|
||||||
|
with either `--enable-shared` or `--enable-framework` (on OS X).
|
||||||
|
This is achieved as follows (NOTE: for Mac, replace `--enable-shared`
|
||||||
|
with `--enable-framework`):
|
||||||
|
|
||||||
|
- When building python from source: `./configure --enable-shared {options}`
|
||||||
|
- When building python from pyenv:
|
||||||
|
`PYTHON_CONFIGURE_OPTS="--enable-shared" pyenv install {version}`
|
||||||
|
|
||||||
|
|
||||||
|
## `install.py` says python must be compiled with `--enable-framework`. Wat?
|
||||||
|
|
||||||
|
See the previous answer for how to ensure your python is built to support
|
||||||
|
dynamic modules.
|
||||||
|
|
||||||
### YCM does not read identifiers from my tags files
|
### YCM does not read identifiers from my tags files
|
||||||
|
|
||||||
First, put `let g:ycm_collect_identifiers_from_tags_files = 1` in your vimrc.
|
First, put `let g:ycm_collect_identifiers_from_tags_files = 1` in your vimrc.
|
||||||
|
|||||||
@ -138,28 +138,30 @@ Contents ~
|
|||||||
14. I get 'LONG_BIT definition appears wrong for platform' when compiling |LONG_BIT-definition-appears-wrong-for-platform|
|
14. I get 'LONG_BIT definition appears wrong for platform' when compiling |LONG_BIT-definition-appears-wrong-for-platform|
|
||||||
15. I get 'libpython2.7.a [...] relocation R_X86_64_32' when compiling |libpython2.7.a-...-relocation-R_X86_64_32|
|
15. I get 'libpython2.7.a [...] relocation R_X86_64_32' when compiling |libpython2.7.a-...-relocation-R_X86_64_32|
|
||||||
16. I get 'Vim: Caught deadly signal SEGV' on Vim startup |Vim:-Caught-deadly-signal-SEGV|
|
16. I get 'Vim: Caught deadly signal SEGV' on Vim startup |Vim:-Caught-deadly-signal-SEGV|
|
||||||
17. YCM does not read identifiers from my tags files |youcompleteme-ycm-does-not-read-identifiers-from-my-tags-files|
|
17. I get 'Fatal Python error: PyThreadState_Get: no current thread' on startup |Fatal-Python-error:-PyThreadState_Get:-no-current-thread|
|
||||||
18. 'CTRL-U' in insert mode does not work |CTRL-sub-U|
|
11. |install.py| says python must be compiled with '--enable-framework'. Wat?
|
||||||
19. YCM conflicts with UltiSnips TAB key usage |youcompleteme-ycm-conflicts-with-ultisnips-tab-key-usage|
|
1. YCM does not read identifiers from my tags files |youcompleteme-ycm-does-not-read-identifiers-from-my-tags-files|
|
||||||
20. Why isn't YCM just written in plain VimScript, FFS? |youcompleteme-why-isnt-ycm-just-written-in-plain-vimscript-ffs|
|
2. 'CTRL-U' in insert mode does not work |CTRL-sub-U|
|
||||||
21. Why does YCM demand such a recent version of Vim? |youcompleteme-why-does-ycm-demand-such-recent-version-of-vim|
|
3. YCM conflicts with UltiSnips TAB key usage |youcompleteme-ycm-conflicts-with-ultisnips-tab-key-usage|
|
||||||
22. I get annoying messages in Vim's status area when I type |youcompleteme-i-get-annoying-messages-in-vims-status-area-when-i-type|
|
4. Why isn't YCM just written in plain VimScript, FFS? |youcompleteme-why-isnt-ycm-just-written-in-plain-vimscript-ffs|
|
||||||
23. Nasty bugs happen if I have the 'vim-autoclose' plugin installed |vim-sub-autoclose|
|
5. Why does YCM demand such a recent version of Vim? |youcompleteme-why-does-ycm-demand-such-recent-version-of-vim|
|
||||||
24. Is there some sort of YCM mailing list? I have questions |youcompleteme-is-there-sort-of-ycm-mailing-list-i-have-questions|
|
6. I get annoying messages in Vim's status area when I type |youcompleteme-i-get-annoying-messages-in-vims-status-area-when-i-type|
|
||||||
25. I get an internal compiler error when installing |youcompleteme-i-get-an-internal-compiler-error-when-installing|
|
7. Nasty bugs happen if I have the 'vim-autoclose' plugin installed |vim-sub-autoclose|
|
||||||
26. I get weird errors when I press 'Ctrl-C' in Vim |Ctrl-sub-C|
|
8. Is there some sort of YCM mailing list? I have questions |youcompleteme-is-there-sort-of-ycm-mailing-list-i-have-questions|
|
||||||
27. Why did YCM stop using Syntastic for diagnostics display? |youcompleteme-why-did-ycm-stop-using-syntastic-for-diagnostics-display|
|
9. I get an internal compiler error when installing |youcompleteme-i-get-an-internal-compiler-error-when-installing|
|
||||||
28. Completion doesn't work with the C++ standard library headers |youcompleteme-completion-doesnt-work-with-c-standard-library-headers|
|
10. I get weird errors when I press 'Ctrl-C' in Vim |Ctrl-sub-C|
|
||||||
29. Install YCM with NeoBundle [55] |youcompleteme-install-ycm-with-neobundle-55|
|
11. Why did YCM stop using Syntastic for diagnostics display? |youcompleteme-why-did-ycm-stop-using-syntastic-for-diagnostics-display|
|
||||||
30. When I open a JavaScript file, I get an annoying warning about '.tern-project'
|
12. Completion doesn't work with the C++ standard library headers |youcompleteme-completion-doesnt-work-with-c-standard-library-headers|
|
||||||
|
13. Install YCM with NeoBundle [55] |youcompleteme-install-ycm-with-neobundle-55|
|
||||||
|
14. When I open a JavaScript file, I get an annoying warning about '.tern-project'
|
||||||
file |.tern-sub-project|
|
file |.tern-sub-project|
|
||||||
31. When I start vim I get a runtime error saying 'R6034 An application has made an
|
15. When I start vim I get a runtime error saying 'R6034 An application has made an
|
||||||
attempt to load the C runtime library incorrectly.' |R6034-An-application-has-made-an-attempt-to-load-the-C-runtime-library-incorrectly.|
|
attempt to load the C runtime library incorrectly.' |R6034-An-application-has-made-an-attempt-to-load-the-C-runtime-library-incorrectly.|
|
||||||
32. I hear that YCM only supports Python 2, is that true? |youcompleteme-i-hear-that-ycm-only-supports-python-2-is-that-true|
|
16. I hear that YCM only supports Python 2, is that true? |youcompleteme-i-hear-that-ycm-only-supports-python-2-is-that-true|
|
||||||
11. Contributor Code of Conduct |youcompleteme-contributor-code-of-conduct|
|
12. Contributor Code of Conduct |youcompleteme-contributor-code-of-conduct|
|
||||||
12. Contact |youcompleteme-contact|
|
13. Contact |youcompleteme-contact|
|
||||||
13. License |youcompleteme-license|
|
14. License |youcompleteme-license|
|
||||||
14. References |youcompleteme-references|
|
15. References |youcompleteme-references|
|
||||||
|
|
||||||
===============================================================================
|
===============================================================================
|
||||||
*youcompleteme-introduction*
|
*youcompleteme-introduction*
|
||||||
@ -570,20 +572,20 @@ Compiling YCM **without** semantic support for C-family languages:
|
|||||||
<
|
<
|
||||||
The following additional language support options are available:
|
The following additional language support options are available:
|
||||||
|
|
||||||
- C# support: add '--omnisharp-completer' when calling 'install.py'. Be sure
|
- C# support: add '--omnisharp-completer' when calling |install.py|. Be sure
|
||||||
that the build utility 'msbuild' is in your PATH [29].
|
that the build utility 'msbuild' is in your PATH [29].
|
||||||
|
|
||||||
- Go support: ensure go is installed and add '--gocode-completer' when
|
- Go support: ensure go is installed and add '--gocode-completer' when
|
||||||
calling 'install.py'.
|
calling |install.py|.
|
||||||
|
|
||||||
- TypeScript support: install nodejs and npm [22] then install the TypeScript
|
- TypeScript support: install nodejs and npm [22] then install the TypeScript
|
||||||
SDK with 'npm install -g typescript'.
|
SDK with 'npm install -g typescript'.
|
||||||
|
|
||||||
- JavaScript support: install nodejs and npm [22] and add '--tern-completer'
|
- JavaScript support: install nodejs and npm [22] and add '--tern-completer'
|
||||||
when calling 'install.py'.
|
when calling |install.py|.
|
||||||
|
|
||||||
- Rust support: install rustc and cargo [23] and add '--racer-completer' when
|
- Rust support: install rustc and cargo [23] and add '--racer-completer' when
|
||||||
calling 'install.py'.
|
calling |install.py|.
|
||||||
|
|
||||||
To simply compile with everything enabled, there's a '--all' flag. So, to
|
To simply compile with everything enabled, there's a '--all' flag. So, to
|
||||||
install with all language features, ensure 'npm', 'go', 'mono', 'rust', and
|
install with all language features, ensure 'npm', 'go', 'mono', 'rust', and
|
||||||
@ -2778,6 +2780,30 @@ CompileCommands API) were added after their cut.
|
|||||||
So just go through the installation guide and make sure you are using a correct
|
So just go through the installation guide and make sure you are using a correct
|
||||||
'libclang.so'. I recommend downloading prebuilt binaries from llvm.org.
|
'libclang.so'. I recommend downloading prebuilt binaries from llvm.org.
|
||||||
|
|
||||||
|
-------------------------------------------------------------------------------
|
||||||
|
*Fatal-Python-error:-PyThreadState_Get:-no-current-thread*
|
||||||
|
I get 'Fatal Python error: PyThreadState_Get: no current thread' on startup ~
|
||||||
|
|
||||||
|
This is caused by linking a static version of |libpython| into ycmd's
|
||||||
|
'ycm_core.so'. This leads to multiple copies of the python interpreter loaded
|
||||||
|
when 'python' loads 'ycmd_core.so' and this messes up python's global state.
|
||||||
|
The details aren't important.
|
||||||
|
|
||||||
|
The solution is that the version of Python linked and run against must be built
|
||||||
|
with either '--enable-shared' or '--enable-framework' (on OS X). This is
|
||||||
|
achieved as follows (NOTE: for Mac, replace '--enable-shared' with '--enable-
|
||||||
|
framework'):
|
||||||
|
|
||||||
|
- When building python from source: './configure --enable-shared {options}'
|
||||||
|
- When building python from pyenv: 'PYTHON_CONFIGURE_OPTS="--enable-shared"
|
||||||
|
pyenv install {version}'
|
||||||
|
|
||||||
|
===============================================================================
|
||||||
|
*install.py* says python must be compiled with '--enable-framework'. Wat?
|
||||||
|
|
||||||
|
See the previous answer for how to ensure your python is built to support
|
||||||
|
dynamic modules.
|
||||||
|
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
*youcompleteme-ycm-does-not-read-identifiers-from-my-tags-files*
|
*youcompleteme-ycm-does-not-read-identifiers-from-my-tags-files*
|
||||||
YCM does not read identifiers from my tags files ~
|
YCM does not read identifiers from my tags files ~
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user