From fdba724f077ff88d33bdc6f55881b3a91c1b3519 Mon Sep 17 00:00:00 2001
From: Pavel Davydov <pdavydov108@gmail.com>
Date: Mon, 26 Mar 2018 16:32:04 +0300
Subject: [PATCH] Add comment with short issue description. (#545)

---
 src/project.cc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/project.cc b/src/project.cc
index f3c2547e..bf3f4968 100644
--- a/src/project.cc
+++ b/src/project.cc
@@ -75,6 +75,10 @@ struct ProjectConfig {
 
 // TODO: See
 // https://github.com/Valloric/ycmd/blob/master/ycmd/completers/cpp/flags.py.
+// Flags '-include' and '-include-pch' are blacklisted here cause libclang returns error in case when
+// precompiled header was generated by a different compiler (even two different builds of same version
+// of clang for the same platform are incompatible). Note that libclang always generate it's own pch
+// internally. For details, see https://github.com/Valloric/ycmd/issues/892 .
 std::vector<std::string> kBlacklistMulti = {
     "-MF", "-MT", "-MQ", "-o", "--serialize-diagnostics", "-Xclang", "-include", "-include-pch"};