Issue #162: update help text for newExtent, plus the primary commands…

… that call newExtent: createStone, smalltalkCI, and upgradeStone

bin/createStone

@@ -48,7 +48,13 @@ OPTIONS
   -n
      No startStone, no startNetldi.
   -s <snapshot-file-path> 
-     path to snapshot file used to create stone.
+     Path to snapshot file used to create stone. Path may be a relative file
+     path. The snapshot file may be an extent file (raw, zipped (.zip) or 
+     gzipped (.gz)) or a backup file. If the file is compressed, it will be
+     uncompressed into the target extents directory. If the file is a backup
+     file, a \$GEMSTONE/bin/extent0.dbf will be copied into the target
+     extents directory and then the backup will be restored without replaying 
+     tranlogs.
   -t <tode-snapshot-file-path>
      path to snapshot file used to create stone. It is assumed that the snapshot
      already has tODE installed and the snapshot will be attached to the

bin/newExtent

@@ -41,8 +41,13 @@ OPTIONS
      (http://downloads.gemtalksystems.com/docs/GemStone64/3.2.x/GS64-SysAdmin-3.2/GS64-SysAdmin-3.2.htm?http://downloads.gemtalksystems.com/docs/GemStone64/3.2.x/GS64-SysAdmin-3.2/9-BackupAndRestore.htm#pgfId-999128)
      before using the -n option.
   -s <snapshot-file-path> 
-     Path to snapshot file used to create stone. Path may be a relative file 
-     path.
+     Path to snapshot file used to create stone. Path may be a relative file
+     path. The snapshot file may be an extent file (raw, zipped (.zip) or 
+     gzipped (.gz)) or a backup file. If the file is compressed, it will be
+     uncompressed into the target extents directory. If the file is a backup
+     file, a \$GEMSTONE/bin/extent0.dbf will be copied into the target
+     extents directory and then the backup will be restored without replaying 
+     tranlogs.
   -t
      Attach image to the \$GS_TODE/sys/stones/<stone-name> directory structure,
      using the rebuildServerTode client script 

bin/smalltalkCI

@@ -30,7 +30,14 @@ OPTIONS
      already has tODE installed and the snapshot attached to the existing 
      \$GS_TODE/sys/stones/<stone-name> structure before installing SmalltalkCI
   -s <snapshot-file-path>
-     Path to snapshot file used to create stone. Extent is used without doing anything other than install SmalltalkCI.
+     Path to snapshot file used to create stone. Extent is used without doing 
+     anything other than install SmalltalkCI. Path may be a relative file
+     path. The snapshot file may be an extent file (raw, zipped (.zip) or 
+     gzipped (.gz)) or a backup file. If the file is compressed, it will be
+     uncompressed into the target extents directory. If the file is a backup
+     file, a \$GEMSTONE/bin/extent0.dbf will be copied into the target
+     extents directory and then the backup will be restored without replaying 
+     tranlogs.
   -z <smalltalkCI-smalltalk.ston-path>
      Customize the stone installation according to the attrbutes specified in the 
      <smalltalkCI-smalltalk.ston-path> file.

bin/upgradeStone

@@ -30,7 +30,13 @@ OPTIONS
       Default: 100000
   -s <source-stone-extent-file-path> 
      Path to  <source-stone-name> extent file used as starting point for 
-     upgrade.
+     upgrade. Path may be a relative file path. The snapshot file may be
+     an extent file (raw, zipped (.zip) or gzipped (.gz)) or a backup file.
+     If the file is compressed, it will be uncompressed into the target
+     extents directory. If the file is a backup file, a 
+     \$GEMSTONE/bin/extent0.dbf will be copied into the target extents
+     directory and then the backup will be restored without replaying
+     tranlogs.
   -u 
      Skip creation of <target-stone-name> and only run the upgrade step.
   -U <gemstone-user-name>