cmake: improve comments

c++/CMakeLists.txt

@@ -56,6 +56,7 @@ endif()
 
 if(CAPNP_LITE)
   set(CAPNP_LITE_FLAG "-DCAPNP_LITE")
+  # This flag is attached as PUBLIC target_compile_definition to kj target
 else()
   set(CAPNP_LITE_FLAG)
 endif()

c++/cmake/CapnProtoConfig.cmake.in

 # Example usage:
 #   find_package(CapnProto)
 #   capnp_generate_cpp(CAPNP_SRCS CAPNP_HDRS schema.capnp)
+#   include_directories(${CMAKE_CURRENT_BINARY_DIR})
 #   add_executable(foo main.cpp ${CAPNP_SRCS})
-#   target_link_libraries(foo CapnProto::capnp CapnProto::capnp-rpc)
+#   target_link_libraries(foo CapnProto::capnp)
 #
-#  If you are using not using the RPC features you can remove
-#  'CapnProto::capnp-rpc' from the target_link_libraries call
+#  If you are using RPC features, use 'CapnProto::capnp-rpc'
+#  in target_link_libraries call.
 #
 @PACKAGE_INIT@
 

c++/cmake/CapnProtoMacros.cmake

@@ -5,10 +5,10 @@
 #   capnp_generate_cpp(CAPNP_SRCS CAPNP_HDRS schema.capnp)
 #   include_directories(${CMAKE_CURRENT_BINARY_DIR})
 #   add_executable(foo main.cpp ${CAPNP_SRCS})
-#   target_link_libraries(foo CapnProto::capnp)
+#   target_link_libraries(foo CapnProto::capnp-rpc)
 #
-#  If you are using not using the RPC features you can remove
-#  'CapnProto::capnp-rpc' from the target_link_libraries call
+#  If you are using not using the RPC features you can use
+#  'CapnProto::capnp' in target_link_libraries call
 #
 # Configuration variables (optional):
 #   CAPNPC_OUTPUT_DIR