From 0682c1ad02c51be281ebdfd2714d1fdb7123a65d Mon Sep 17 00:00:00 2001
From: Jack Nagel <jacknagel@gmail.com>
Date: Mon, 21 Apr 2014 10:40:26 -0500
Subject: [PATCH] Add some comments to the cc wrapper

---
 Library/ENV/4.3/cc | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Library/ENV/4.3/cc b/Library/ENV/4.3/cc
index 36dfcbbfc0..034a1f64e6 100755
--- a/Library/ENV/4.3/cc
+++ b/Library/ENV/4.3/cc
@@ -230,6 +230,7 @@ class Cmd
     syspath.reject { |d| d == brewfix }.map! { |d| File.join(d, "lib") }
   end
 
+  # Paths added as "-isystem<path>" and "-I<path>" flags
   def cpath
     cpath  = path_split("CMAKE_PREFIX_PATH").map! { |d| File.join(d, "include") }
     cpath += path_split("CMAKE_INCLUDE_PATH")
@@ -238,6 +239,7 @@ class Cmd
     [sys, opt]
   end
 
+  # Paths added as "-L<path>" flags
   def libpath
     libpath  = path_split("CMAKE_PREFIX_PATH").map! { |d| File.join(d, "lib") }
     libpath += path_split("CMAKE_LIBRARY_PATH")
@@ -258,10 +260,11 @@ class Cmd
     args
   end
 
+  # Keg-only opt paths get the "-I" treatment since it has higher priority that
+  # "-isystem", and we want them to be searched before system directories as
+  # well as any directories added by the build system.
   def cppflags
     sys, opt = cpath
-    # we want our keg-only includes to be found before system includes *and*
-    # before any other includes the build-system adds
     path_flags("-isystem", sys) + path_flags("-I", opt)
   end