home *** CD-ROM | disk | FTP | other *** search
/ Joystick Magazine 1996 April / cd2.iso / demos / riserule / pkcomp.txt < prev    next >
Text File  |  1994-10-25  |  4KB  |  71 lines
  1. PKCOMP allows the SIERRA developer to specify some switch parameters for
  2. compression. PKCOMP will create subdirectories from a supplied (or default)
  3. destination and proceed to compress files into DISKn directories starting
  4. at DISK1 until completed. If the collection of files is too great for the 
  5. size of a disk then a new directory, DISK(n+1), will be generated. There
  6. are several command line parameters that can be specified for compression
  7. of files. 
  8.  
  9.     /A<size>        - Sets the maximum size for compression files for
  10.               for each disk. The default is 1457664 (approx
  11.               1.44 MB) 
  12.     /L<filename>    - Listfile of all files to be compressed. The full 
  13.               path name must be included in this list. One
  14.               filename per line <cr> delimeted.
  15.     /F<n><size>     - Sets the maximum size for DISK<n> at <size> bytes.
  16.               This allows for room to be left on specific disks
  17.               for other files. There may be a maximum of 5 '/F'
  18.               switches.
  19.     /D<directory>   - Destination directory path. This is where PKCOMP
  20.               will create the DISKn subdirectories. (Default is
  21.               CurrentDir)
  22.     /N<filename>    - Destination filename. This will be the name of the
  23.               compression file. (Default = RESOURCE.000)
  24.     /C<filenames>   - Filenames to compress. May have '*' wildcards. There
  25.               can be a maximum of 5 '/C' switches (otherwise use
  26.               the '/L' switch). This switch cannot be used with the
  27.               /L switch.
  28.     /S<n>           - Start at disk number (1-n)
  29.     /X              - Perform no compression. This switch is used to simply
  30.               create a PKCOMP.INF file that lists the files and
  31.               their sizes for the SIERRA.INF file.
  32.     /Z        - Performs no compression, BUT does create a "archive"
  33.               file. This file is then treated as a compressed file.
  34.               This switch is used to break up large resouce files
  35.               that may already be compressed.
  36.  
  37. Upon completion of the PKCOMP utility a file called PKCOMP.INF is generated in
  38. the destination directory. This file is created in the format to be used in the
  39. SIERRA.INF file to be shipped with the product. The data in the file should be
  40. cut and paste into your product script file.
  41.  
  42. Examples of the PKCOMP utility is as follows:
  43.  
  44.     PKCOMP /dc:\productX /f11357664 /f21357664 /Lmylist.txt
  45.  
  46. This creates a compression file called RESOURCE.000 (default) under the 
  47. c:\productX directory. It will first create a subdirectory DISK1. The 
  48. compressed file in the first subdirectory (as well as DISK2) will be no
  49. greater than 1,357,664 bytes. This leaves room on the first two disks of
  50. 100 KB each. All the files to be compressed can be found in a file called
  51. mylist.txt.
  52.  
  53.     PKCOMP /a1000000 /c*.avi /c*.wav /c*.mid /cbitmaps\*.bmp /nAUDVID.000
  54.  
  55. The above example produces a compressed archive file under the current
  56. directory in subdirectories DISK1 to DISKn all compressed files will be
  57. no greater than 1 MB and will contain all AVI, WAV and MID files from
  58. the current directory and all bitmaps from the BITMAPS subdirectory. The
  59. files will be compressed into an archive named AUDVID.000.
  60.  
  61.     PKCOMP /c*.* /x
  62.  
  63. As the script file, SIERRA.INF, requires ALL files associated with a product
  64. to be listed, the above example provides a way to generate a PKCOMP.INF file
  65. for those files not being compressed. This example will find all the filenames
  66. and sizes of files in the current directory and put them into a PKCOMP.INF
  67. file for use to cut and paste into a product's SIERRA.INF file. The PKCOMP.INF
  68. file can be found in the destination directory, in this case, the current
  69. working directory.
  70.  
  71.