macOS: update macdeployqt documentation

This patch adds missing command line arguments as well as warning for
the behavior of the tool regarding the use of the host file system as
reference to generate .dmg.

Task-number: QTBUG-65844
Change-Id: Ia0d9483fb0cf60073e0f4f5489f2fba6b5675679
Reviewed-by: Sze Howe Koh <szehowe.koh@gmail.com>

1 files changed, 21 insertions, 0 deletions

diff --git a/doc/src/platforms/osx.qdoc b/doc/src/platforms/osx.qdoc
index 4a7c21f4..5d357767 100644
--- a/doc/src/platforms/osx.qdoc
+++ b/doc/src/platforms/osx.qdoc
@@ -1146,7 +1146,28 @@
     \row
         \li \c{-qmldir=<path>}
         \li Deploy imports used by .qml files in the given path
+    \row
+        \li \c{-always-overwrite}
+        \li Copy files even if the target file exists
+    \row
+        \li \c{-codesign=<ident>}
+        \li Run \c codesign with the given identity on all executables
+    \row
+        \li \c{-appstore-compliant}
+        \li Skip deployment of components that use private API
+    \row
+        \li \c{-libpath=<path>}
+        \li Add the given path to the library search path
+    \row
+        \li \c{-fs=<filesystem>}
+        \li Set the filesystem used for the .dmg disk image (defaults to HFS+)
     \endtable
+
+    \note macOS High Sierra introduced the new Apple File System (APFS). Older
+    versions of macOS cannot read .dmg files that are formatted with APFS. By
+    default, \c macdeployqt uses the older HFS+ file system for compatibility
+    with all versions of macOS currently supported by Qt. Use the \c{-fs} option
+    to specify a different file system.
 */
 
 /*!