macOS: add examples to Project.xcconfig for setting custom app icon(s…

…) and note about transitioning from oF 0.7.2-0.11 ICON_FILE_PATH variable

commandLine/Project.xcconfig

@@ -18,23 +18,36 @@ DEVELOPMENT_LANGUAGE = English
 CODE_SIGN_IDENTITY = -
 INFOPLIST_FILE = openFrameworks-Info.plist
 
-// Versioning, uncomment to override settings in Xcode UI
+// VERSIONING - uncomment to override settings in Xcode UI
+
 // this is "Version" in the Xcode target Identity UI
 // suggested to use semantic versioning format ala #.#.#
 //MARKETING_VERSION = 0.1.0
+
 // this is "Build" in the Xcode target Identity UI, an incremental build number
 // important for the App Store as new build submissions need a diff number even
-// if version is the same
+// if MARKETING_VERSION is the same
 //CURRENT_PRODUCT_VERSION = 1
 
-//ICONS - NEW IN 0072 
-//ICON_NAME = icon.icns
-//ICON_NAME[config=Debug] = icon-debug.icns
+// ICONS
+
+// default oF app icon
 ICON_NAME = of.icns
 ICON_NAME[config=Debug] = of_debug.icns
 ICON_FILE = $(OF_PATH)/libs/openFrameworksCompiled/project/osx/$(ICON_NAME)
-//IF YOU WANT AN APP TO HAVE A CUSTOM ICON - PUT THEM IN YOUR DATA FOLDER AND CHANGE ICON_FILE_PATH to:
-//ICON_FILE_PATH = bin/data/
+
+// custom app icon, placed in main project folder
+//ICON_NAME = MyApp.icns
+//ICON_FILE = $(ICON_NAME)
+
+// custom app icon with separate Release and Debug versions placed in bin/data
+//ICON_NAME = icon.icns
+//ICON_NAME[config=Debug] = icon-debug.icns
+//ICON_FILE = bin/data/$(ICON_NAME)
+
+// note: oF 0.7.2 - 0.11 used ICON_FILE_PATH which is no longer used in oF 0.12+
+// ex. change ICON_FILE_PATH = bin/data/ -> ICON_FILE = bin/data/$(ICON_NAME) &
+// in a custom openFrameworks-Info.plist, set CFBundleIconFile to ICON_NAME
 
 //FOR AV ENGINE SOUND PLAYER UNCOMMENT TWO LINES BELOW
 //OF_NO_FMOD=1