Open Radar

 
The asset catalog compiler command line tool (actool)'s man page is very outdated. According to the footer, it hasn't been updated since December 2011. This is an issue for us at The Qt Company / Qt Project because we invoke actool ourselves instead of relying entirely on Xcode for the development and deployment of macOS, iOS, tvOS, and watchOS applications.

It's clear from the (documented) build options in Xcode that the IDE passes several undocumented command line flags to actool as shown in the build logs, which look like they should be documented and may be particularly relevant to us. In fact, we use several of them in our new build tool despite them being effectively undocumented. It would be nice if the man page was updated so we know which flags are clearly meant for public use.

A few examples include:
--product-type (PRODUCT_TYPE) - clear what it is, but would be nice to know WHY actool needs this when run under Xcode
--enable-incremental-distill (ENABLE_INCREMENTAL_DISTILL) - no idea what this even does, why is it documented in Xcode?
--compress-pngs (COMPRESS_PNG_FILES) - no longer shown in Xcode UI, but always enabled, so we do it too
--enable-on-demand-resources (ENABLE_ON_DEMAND_RESOURCES)
--optimization (ASSETCATALOG_COMPILER_OPTIMIZATION)
--filter-for-device-model (ENABLE_ONLY_ACTIVE_RESOURCES)
--filter-for-device-os-version (ENABLE_ONLY_ACTIVE_RESOURCES)
--sticker-pack-identifier-prefix (ASSETCATALOG_COMPILER_STICKER_PACK_IDENTIFIER_PREFIX)

Steps to Reproduce:
Run `man actool`

Expected Results:
All relevant options are documented

Observed Results:
The man page was last updated in 2011 and newer options are missing