CPack/DragNDrop: Update documentation to include new variables

Document the new behavior of `CPACK_DMG_BACKGROUND_IMAGE` and the
purpose of `CPACK_DMG_DS_STORE_SETUP_SCRIPT`.
This commit is contained in:
Robert Maynard 2014-12-18 14:56:37 -05:00 committed by Brad King
parent 167a465565
commit c4b9ee1878
2 changed files with 23 additions and 5 deletions

View File

@ -0,0 +1,8 @@
better-looking-mac-packages
---------------------------
* The :module:`CPackDMG` module learned new variable to specify AppleScript
file run to customize appearance of ``DragNDrop`` installer folder,
including background image setting using supplied PNG or multi-resolution
TIFF file. See the :variable:`CPACK_DMG_DS_STORE_SETUP_SCRIPT` and
:variable:`CPACK_DMG_BACKGROUND_IMAGE` variables.

View File

@ -26,15 +26,25 @@
# Path to a custom DS_Store file. This .DS_Store file e.g. can be used to # Path to a custom DS_Store file. This .DS_Store file e.g. can be used to
# specify the Finder window position/geometry and layout (such as hidden # specify the Finder window position/geometry and layout (such as hidden
# toolbars, placement of the icons etc.). This file has to be generated by # toolbars, placement of the icons etc.). This file has to be generated by
# the Finder (either manually or through OSA-script) using a normal folder # the Finder (either manually or through AppleScript) using a normal folder
# from which the .DS_Store file can then be extracted. # from which the .DS_Store file can then be extracted.
# #
# .. variable:: CPACK_DMG_DS_STORE_SETUP_SCRIPT
#
# Path to a custom AppleScript file. This AppleScript is used to generate
# a .DS_Store file which specifies the Finder window position/geometry and
# layout (such as hidden toolbars, placement of the icons etc.).
# By specifying a custom AppleScript there is no need to use
# CPACK_DMG_DS_STORE, as the .DS_Store that is generated by the AppleScript
# will be packaged.
#
# .. variable:: CPACK_DMG_BACKGROUND_IMAGE # .. variable:: CPACK_DMG_BACKGROUND_IMAGE
# #
# Path to a background image file. This file will be used as the background # Path to an image file to be used as the background. This file will be
# for the Finder Window when the disk image is opened. By default no # copied to .background/background.<ext>, where ext is the original image file
# background image is set. The background image is applied after applying the # extension. The background image is installed into the image before
# custom .DS_Store file. # CPACK_DMG_DS_STORE_SETUP_SCRIPT is executed or CPACK_DMG_DS_STORE is
# installed. By default no background image is set.
# #
# .. variable:: CPACK_DMG_SLA_DIR # .. variable:: CPACK_DMG_SLA_DIR
# #