Mercurial > vim-crosoft
view doc/vimcrosoft.vim @ 10:f444739dd8af
Improvements to YCM dynamic flags.
- Fallback to a "companion" item (e.g. header/source) or a nearby item
when no flags are found for an item.
- Finding a "companion" is also exposed as a standalone script.
- Ability to pass extra clang flags, including some from a special
file found in the .vimcrosoft directory.
- Add support for PCH and other forced-include files.
- Add options for short/long args, or forcing forward slashes.
- Debugging/troubleshooting options, including dumping a batch file and
response file to run clang directly, and the ability to auto-load a
solution's last known environment when running in command line.
| author | Ludovic Chabant <ludovic@chabant.com> |
|---|---|
| date | Thu, 24 Sep 2020 23:02:16 -0700 |
| parents | 5d2c0db51914 |
| children |
line wrap: on
line source
*vimcrosoft.txt* Work with Visual Studio solutions in Vim $$\ $$\$$$$$$\$$\ $$\ $$$$$$\ $$$$$$$\ $$$$$$\ $$$$$$\ $$$$$$\ $$$$$$$$\$$$$$$$$\ $$ | $$ \_$$ _$$$\ $$$ $$ __$$\$$ __$$\$$ __$$\$$ __$$\$$ __$$\$$ _____\__$$ __| $$ | $$ | $$ | $$$$\ $$$$ $$ / \__$$ | $$ $$ / $$ $$ / \__$$ / $$ $$ | $$ | \$$\ $$ | $$ | $$\$$\$$ $$ $$ | $$$$$$$ $$ | $$ \$$$$$$\ $$ | $$ $$$$$\ $$ | \$$\$$ / $$ | $$ \$$$ $$ $$ | $$ __$$<$$ | $$ |\____$$\$$ | $$ $$ __| $$ | \$$$ / $$ | $$ |\$ /$$ $$ | $$\$$ | $$ $$ | $$ $$\ $$ $$ | $$ $$ | $$ | \$ / $$$$$$\$$ | \_/ $$ \$$$$$$ $$ | $$ |$$$$$$ \$$$$$$ |$$$$$$ $$ | $$ | \_/ \______\__| \__|\______/\__| \__|\______/ \______/ \______/\__| \__| VIM-CROSOFT *vimcrosoft* ============================================================================== Configuration *vimcrosoft-configuration* *g:vimcrosoft_trace* g:vimcrosoft_trace Enables debugging information. Default: `0` *g:vimcrosoft_auto_find_sln* g:vimcrosoft_auto_find_sln Try and find a solution for the current working directory on Vim startup. This effectively executes |:VimcrosoftAutoFindSln| upon startup. Default: `0` *g:vimcrosoft_sln_finder* g:vimcrosoft_sln_finder The name of a function to call to find a solution file from a given current path. If not set, Vimcrosoft will use its own default finder, which just walks up the directory tree until it finds any `*.sln` files. Default: `""` *g:vimcrosoft_msbuild_path* g:vimcrosoft_msbuild_path By default, Vimcrosoft automatically finds where MSBuild is installed. If that fails, you can specify the path to the MSBuild executable directly. Default: `""` *g:vimcrosoft_make_command* g:vimcrosoft_make_command The command to run when starting builds. If empty, Vimcrosoft will use |:make|, unless the vim-dispatch plugin is detected, in which case it will use |:Make|. If the option is not empty, it will use whatever you specified. Default: `""` ============================================================================== Commands *vimcrosoft-commands* *vimcrosoft-solution-commands* Here's a list of solution-related commands: *:VimcrosoftAutoFindSln* :VimcrosoftAutoFindSln Finds a solution file (`*.sln`) in the current working directory, or any of its parent directories, and sets it as the current solution file (see |:VimcrosoftSetSln|). If any solution files are found, the first one is used. *:VimcrosoftSetSln* :VimcrosoftSetSln <file> Sets the currently active solution file. All vim-crosoft commands will relate to this solution. *:VimcrosoftUnsetSln* :VimcrosoftUnsetSln Unsets the currently active solution file. *:VimcrosoftSetConfigPlatform* :VimcrosoftSetConfigPlatform <configplatform> Sets the currently active configuration and platform for the active solution. The argument is a combo of configuration and platform, in the form of `Configuration|Platform`. *:VimcrosoftBuildSln* :VimcrosoftBuildSln Starts a build on the current solution, using the current configuration and platform. *:VimcrosoftRebuildSln* :VimcrosoftRebuildSln Rebuilds the current solution, using the current configuration and platform. *:VimcrosoftCleanSln* :VimcrosoftCleanSln Cleans the current solution for the current configuration and platform. *vimcrosoft-project-commands* Here are some project-related commands: *:VimcrosoftBuildProject* :VimcrosoftBuildProject Builds the active project for the current configuration and platform. MSBuild will typically build all its dependencies first. *:VimcrosoftBuildProjectOnly* :VimcrosoftBuildProjectOnly Builds the active project for the current configuration and platform, but skips building any dependencies. *:VimcrosoftRebuildProject* :VimcrosoftRebuildProject Rebuilds the active project for the current configuration and platform. *:VimcrosoftCleanProject* :VimcrosoftCleanProject Cleans the active project for the current configuration and platform. *vimcrosoft-active-project-commands* Vimcrosoft lets you specify an "active project" that makes it quicker to build/clean/etc. *:VimcrosoftSetActiveProject* :VimcrosoftSetActiveProject Sets the active project for the current solution. This enables a few "shortcut" commands that operate on it directly. *:VimcrosoftBuildActiveProject* :VimcrosoftBuildActiveProject Builds the active project for the current configuration and platform. MSBuild will typically build all its dependencies first. *:VimcrosoftBuildActiveProjectOnly* :VimcrosoftBuildActiveProjectOnly Builds the active project for the current configuration and platform, but skips building any dependencies. *:VimcrosoftRebuildActiveProject* :VimcrosoftRebuildActiveProject Rebuilds the active project for the current configuration and platform. *:VimcrosoftCleanActiveProject* :VimcrosoftCleanActiveProject Cleans the active project for the current configuration and platform. ============================================================================== Statusline *vimcrosoft-statusline* You can show some vimcrosoft-related information in your 'statusline' by calling the `vimcrosoft#statusline()` function. " vim:tw=78:et:ft=help:norl: