---

Ⅰ. 插件描述

Vim plugin to make working with CMake a little nicer

Ⅱ. 基本信息

创建日期：  2012-05-29 使用用户：  93 Github星：  102 插件作者：  Dirk Van Haerenborgh

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'vhdirk/vim-cmake-back-to-december'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'vhdirk/vim-cmake-back-to-december'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'vhdirk/vim-cmake-back-to-december'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/vhdirk/vim-cmake

Ⅳ. 文档说明

# vim-cmake

vim-cmake is a Vim plugin to make working with CMake a little nicer.

I got tired of navigating to the build directory each time, and I also
disliked setting makeprg manually each time. This plugin does just that.

Usage

Commands

• :CMake searches for the closest directory named build in an upwards search,

1. whenever one is found, it runs the cmake command there, assuming the CMakeLists.txt

file is just one directory above. Any arguments given to :CMake will be directly passed
on to the cmake command. It also sets the working directory of the make command, so
you can just use quickfix as with a normal Makefile project.
If you have the AsyncRun plugin
installed, it will be used automatically and you will be able to check the
result of the cmake command in the quickfix as well.

• :CMakeClean deletes all files in the build directory. You can think of this as a CMake version of make clean.
• :CMakeFindBuildDir resets the build directory path set for the current buffer and then tries to find a new one. Useful if it previously found a wrong path to then reset it after a new build folder has been created for example.

Variables

• g:cmake_install_prefix same as -DCMAKE_INSTALL_PREFIX
• g:cmake_build_type same as -DCMAKE_BUILD_TYPE
• g:cmake_cxx_compiler same as -DCMAKE_CXX_COMPILER. Changes will have no effect until you run :CMakeClean and then :CMake.
• g:cmake_c_compiler same as -DCMAKE_C_COMPILER. Changes will have no effect until you run :CMakeClean and then :CMake.
• g:cmake_build_shared_libs same as -DBUILD_SHARED_LIBS
• g:cmake_project_generator same as -G. Changes will have no effect until you run :CMakeClean and then :CMake.
• g:cmake_export_compile_commands same as -DCMAKE_EXPORT_COMPILE_COMMANDS.
• g:cmake_ycm_symlinks create symlinks to the generated compilation database for use with YouCompleteMe.
• b:build_dir is the path to the cmake build directory for the current buffer. This variable is set with the first :CMake or :CMakeFindBuildDir call. Once found, it will not be searched for again unless you call :CMakeFindBuildDir. If automatic finding is not sufficient you can set this variable manually to the build dir of your choice.

Installation

Vim-pathogen

With pathogen.vim simply copy and paste:

cd ~/.vim/bundle
git clone git://github.com/vhdirk/vim-cmake.git

Once help tags have been generated, you can view the manual with
:help cmake.

Vundle

With Vundle.vim simply add this repository to your plugins list:

Plugin 'vhdirk/vim-cmake'

Acknowledgements

• Thanks to Tim Pope, his plugins are really awesome.
• Thanks to Junegunn Choi, for vader.vim, which is the testing framework used for this plugin.

• Also thanks to

  • @SteveDeFacto for extending this with more fine grained control.
  • @snikulov for enhancing makeprg.
  • @dapicester for allowing specifying targets.
  • @thomasgubler for the build dir option.
  • @antmd for fixing a bug with handing of spaces in directory names.
  • @jmirabel for fixing concatenation of cmake arguments.
  • @T4ng10r for the project generator option.
  • @Squareys for a small overhaul of the project, the initial test and travis setup.

License

Copyright (c) Dirk Van Haerenborgh, @SteveDeFacto. Distributed under the same terms as Vim itself.
See :help license.