CMake: Update docs for cmake "recommended" targets

docs/CMake API.md

@@ -646,21 +646,37 @@ CMake-supplied defaults.
 
 #### `juce::juce_recommended_warning_flags`
 
-    target_link_libraries(myTarget PRIVATE juce::juce_recommended_warning_flags)
+    target_link_libraries(myTarget PUBLIC juce::juce_recommended_warning_flags)
 
 This is a target which can be linked to other targets using `target_link_libraries`, in order to
 enable the recommended JUCE warnings when building them.
 
+This target just sets compiler and linker flags, and doesn't have any associated libraries or
+include directories. When building plugins, it's probably desirable to link this to the shared code
+target with `PUBLIC` visibility, so that all the plugin wrappers inherit the same compile/link
+flags.
+
 #### `juce::juce_recommended_config_flags`
 
-    target_link_libraries(myTarget PRIVATE juce::juce_recommended_config_flags)
+    target_link_libraries(myTarget PUBLIC juce::juce_recommended_config_flags)
 
 This is a target which can be linked to other targets using `target_link_libraries`, in order to
 enable the recommended JUCE optimisation and debug flags.
 
+This target just sets compiler and linker flags, and doesn't have any associated libraries or
+include directories. When building plugins, it's probably desirable to link this to the shared code
+target with `PUBLIC` visibility, so that all the plugin wrappers inherit the same compile/link
+flags.
+
 #### `juce::juce_recommended_lto_flags`
 
-    target_link_libraries(myTarget PRIVATE juce::juce_recommended_lto_flags)
+    target_link_libraries(myTarget PUBLIC juce::juce_recommended_lto_flags)
 
 This is a target which can be linked to other targets using `target_link_libraries`, in order to
 enable the recommended JUCE link time optimisation settings.
+
+This target just sets compiler and linker flags, and doesn't have any associated libraries or
+include directories. When building plugins, it's probably desirable to link this to the shared code
+target with `PUBLIC` visibility, so that all the plugin wrappers inherit the same compile/link
+flags.
+