stuff

Installer/os_nvim_init.vim

@@ -189,6 +189,7 @@ lua <<EOF
     sources = {
       { name = 'nvim_lsp' },
       { name = 'luasnip' },
+      { name = 'buffer' },
     },
   }
 

Installer/win_clang_merge_compilation_command_files.bat

@@ -1,6 +1,11 @@
 @echo off
+REM NOTE: Overview (Version 1)
+REM ----------------------------------------------------------------------------
+REM
 REM Merge multiple compilation command files generated by clang -MJ and dump it
-REM to standard output as a JSON array.
+REM to standard output as a JSON array. This script lets you merge the output
+REM files clang dumps on execution of this command without relying on any
+REM external tools, just pure batch scripting.
 REM
 REM An entry generated by clang -MJ, looks like this:
 REM
@@ -12,6 +17,29 @@ REM   "arguments": ["/usr/bin/clang-5.0", "-xc++", "/tmp/foo.cpp", "--driver-mod
 REM }
 REM
 REM See: https://sarcasm.github.io/notes/dev/compilation-database.html#clang
+REM
+REM NOTE: Examples/Integration
+REM ----------------------------------------------------------------------------
+REM On Windows you can generate this file easily on MSVC projects by utilising
+REM the Clang MSVC CL wrapper in clang-cl which converts MSVC flags into Clang
+REM compatible flags.
+REM
+REM   clang-cl -clang:-MJcompile.json -nologo -W4 -Z7 your_cpp_file.cpp
+REM
+REM If you already use clang on Windows
+REM
+REM   clang -MJcompile.json your_cpp_file.cpp
+REM
+REM You may merge the generated files into a valid compile_commands.json via
+REM this script (by default it dumps to standard out) i.e.
+REM
+REM   clang_merge_compilation_command_files.bat compile.json > compile_commands.json
+REM
+REM NOTE: What's it for?
+REM ----------------------------------------------------------------------------
+REM Compilation commands can be used by LSP so that LSP daemons, like clangd are
+REM able to semantically understand the code and provide code completion, hints
+REM AST operations and so forth.
 
 setlocal EnableDelayedExpansion
 if [%1]==[] (