home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Magazine 19 / CDROM19.iso / Indisp / ACROBAT3 / ABCPYDOC.INI < prev    next >
INI File  |  1996-09-26  |  15KB  |  318 lines
  1. ;*******************************************************************************
  2. ;
  3. ;ABCPYDOC.INI - This file is an example file that shows how to provide the
  4. ;               "blind-copy" capability for use with Adobe Acrobat installations.
  5. ;
  6. ;NOTE:  Do NOT use this file for blind-copy.  It is meant only as an example.
  7. ;*******************************************************************************
  8. ;
  9. ;Blind-copy capability provides a mechanism where an OEM or VAR may add to
  10. ;an installation set.  To trigger the blind-copy mechanism, a file named
  11. ;ABCPY.INI (Adobe Blind CoPY initialization file) must exist in the same 
  12. ;directory as the installer (SETUP.EXE) for Acrobat, whether for the individual
  13. ;Acrobat products or the Acrobat "umbrella". 
  14. ;
  15. ;ABCPY.INI is formatted similar to an .INI file, with section names that must
  16. ;match values set in ACROINST.INI (a hidden file used by Acrobat installations).
  17. ;For example, if an OEM needs the blind-copy capability for an Acrobat Reader
  18. ;installation, a section in ABCPY.INI must be named [ReaderBlindCopy].  If 
  19. ;Acrobat Exchange is the product installed, a section named [ExchangeBlindCopy] 
  20. ;must exist in ABCPY.INI.
  21. ;
  22. ;There are five types of "object actions" that can be added.  1) A "requirement"
  23. ;may be performed, 2) files can be copied, 2) program items or shortcuts 
  24. ;(depending on the target operating system) can be created, 3) registry entries 
  25. ;can be created, and 4) INI entries can be created.
  26. ;
  27. ;To have an action performed on these blind-copy objects, there are several 
  28. ;entries that must be made within the product's blind-copy section.  First,
  29. ;there must be a key named "NumberOfGroups" and this key must have a value
  30. ;of 1 or more.  
  31. ;
  32. ;For each "group", there will need to be entries for operating system platform, 
  33. ;target destination location, source location, and an optional entry for a 
  34. ;"group" name which is used for the group name when program items or shortcuts 
  35. ;are created.  
  36. ;
  37. ;By reviewing the example section in this file, the entries for each group are:
  38. ;Group<X>Platform=All
  39. ;Group<X>DestDir=Org
  40. ;Group<X>Loc=Org
  41. ;Group<X>Name=
  42. ;
  43. ;where <X> is replaced with the number of a specfic group.
  44. ;NOTE: The value for the group can be not larger than the number of groups as 
  45. ;        defined in NumberOfGroups key in this section.
  46. ;
  47. ;The platform key must contain a value contained in the following set: 
  48. ;(All, Win32, Win16, Win95, WinNT, !WinNT).  
  49. ;All means this group is targeted to all Windows operating system. 
  50. ;Win32 means the target platform is Windows 95 or Windows NT.
  51. ;Win16 means the target platform is only 16 bit Windows (3.1x). 
  52. ;Win95 means only Windows 95.  
  53. ;WinNT means only Windows NT
  54. ;!WinNT means the target platform is All except Windows NT.
  55. ;
  56. ;Group<X>DestDir contains the target detination directory name.
  57. ;
  58. ;Group<X>Loc is the source location relative to the main installation directory
  59. ;(i.e. on the source media of the installation set, NOT where the user chose to
  60. ;install Acrobat).
  61. ;
  62. ;All remaining keys are used for performing certain actions.
  63.  
  64. ;Each group can then have entries for the five "object actions" and those actions
  65. ;use the group settings for determining the source, destination, etc.  Below is
  66. ;a description of how to set these up correctly.
  67. ;
  68. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  69. ;REQUIREMENTS
  70. ;
  71. ;To have a "requirement" performed, there must be one line in the group as follows:
  72. ;
  73. ;Group<X>NumberOfRequirements=<Y>, where <X> is the group number and <Y> is the 
  74. ;number of requirement actions to be performed for this group.  At this time, the
  75. ;only supported requirement is running the Windows application REGEDIT.EXE which
  76. ;can be used to add registry entries using a pre-defined registry file.
  77. ;
  78. ;The following shows an example requirement using REGEDIT:
  79. ;
  80. ;Group2NumberOfRequirements=1
  81. ;Group2Requirement1=REGEDIT
  82. ;Group2RegEditFile=Extra\Extra32.REG
  83. ;
  84. ;The key Group<X>RegEditFile=<.REG file> is used to tell the installer where
  85. ;the .REG file exists.  The .REG file must exist on the users system in a
  86. ;sub-directory of the path where Acrobat was installed.  This .REG file will
  87. ;then be run via REGEDIT.EXE.
  88. ;
  89. ;>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  90. ;FILE COPYING
  91. ;
  92. ;To have a file "blind copied" during installation, there must be a key named
  93. ;Group<X>NumberOfFiles, and the value of this key must be the number of files to 
  94. ;be copied from this source location to the group's target destination as defined 
  95. ;in the Group<X>DestDir and Group<X>Loc keys.
  96. ;
  97. ;For each file to be copied, a key of the following format must be defined:
  98. ;Group<X>FileName<Y>, where <X> is the group number and <Y> is the file number.
  99. ;NOTE: The file number cannot be greater than the number of files value.
  100. ;
  101. ;NOTE: There is no mechanism to rename files as they are copied.
  102. ;
  103. ;NOTE: Files will be directly copied.  The blind-copy mechanism would not know
  104. ;      which decompression scheme to use.
  105. ;
  106. ;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  107. ;PROGRAM ITEMS AND SHORTCUTS
  108. ;
  109. ;To    create a program item or shortcut, a key must be defined containing the number
  110. ;of "icons" to be created.
  111. ;
  112. ;If the number is one or more, a key in the following format must be defined:
  113. ;Group<X>Icon<Y> (see notes above regrarding numbering).
  114. ;
  115. ;The value for these keys is rather cryptic, so please bear with this discussion.
  116. ;This type of object action requires a comma-delimited (i.e. separated by commas)
  117. ;value that has a variable number of parameters depending on the value of the first 
  118. ;parameter.
  119. ;
  120. ;The first parameter of the value must be either SYTLE1 or STYLE2.  
  121. ;STYLE1 is used when the object referred to is an executable or an automatically 
  122. ;launched file (i.e if the file's extension automatically launches the correct 
  123. ;executable).
  124. ;STYLE2 is used when the object referred to requires a primary executable to launch
  125. ;the second file (e.g. NOTEPAD.EXE is often used for launching a ReadMe file).
  126. ;
  127. ;Once the STYLE<X> is defined, the second portion refers to the working directory 
  128. ;for the file named in the third portion.  There are a limited number of values allowed
  129. ;for this second parameter.  If the first character is a '$' then the following values
  130. ;are accepted: Windows or WindowsSystem.  These refer to the directory where Windows is
  131. ;installed or the Windows System directory, respectively.
  132. ;
  133. ;As stated above, the third parameter is the name of the executable file (or automatically
  134. ;launched file is that is appropriate).
  135. ;
  136. ;The fourth parameter is the literal text that will be displayed in the Windows UI that
  137. ;describes the main file (for STYLE1 this is the file referred to in the 3rd parameter,
  138. ;for STYLE2 it is the file referred to in the 7th parameter).
  139. ;
  140. ;For the fifth parameter (and last for STYLE1 entries), this is a number for the index to
  141. ;the icon for Windows to use from the 3rd parameter.  This is typically 0 (zero).
  142. ;
  143. ;STYLE2 entries require two more parameters.  The sixth parameter is the location or
  144. ;working directory of the file referenced in the seventh and last parameter.
  145. ;
  146. ;The following explanation of the example entries should clarify most questions.
  147. ;
  148. ;Group1Icon1=STYLE1,Org,Match.exe,Match,0
  149. ;In this example, the above entry will create a program item or shortcut in the same 
  150. ;folder as was used by the Acrobat installation (because Group1Name is blank).  The item
  151. ;will display "Match" (the 4th parameter) as the description, and the command line created 
  152. ;will be for the program named Match.exe that is located in the Org directory below where 
  153. ;the user chose to put their Acrobat program files.  The first icon indexed within Match.exe 
  154. ;will be used in displaying the item.
  155. ;
  156. ;Group1Icon2=STYLE2,$Windows,Notepad.exe,Match ReadMe,0,Org,Readme.txt
  157. ;Here the entry will create a program item or shortcut in the same folder as was used by
  158. ;the Acrobat installation (because Group1Name is blank), for the file named Readme.txt
  159. ;that is located in t