Issue #58: add some more information surrounding the -n option for st…

…oneNewExtent script [ci skip]

bin/stoneNewExtent

@@ -18,13 +18,26 @@ the stone will be restarted with the -N option.
 If the -s option is not specified, $GEMSTONE/bin/extent0.seaside.dbf will be used as 
 the initial extent.
 
-With the -n option, the stone is not restarted and the <snapshot-file-path> is required.
+If the -n option is not specified, the tranlogs in the stone's tranlog directory will 
+be removed before the stone is restarted.
+
+With the -n option, the stone is not restarted, the <snapshot-file-path> is required
+and tranlogs are not removed
+
+Please read the 'How to Restore from Backup' section of the System Administration manual 
+(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.
+
 
 OPTIONS
   -h
      display help
   -n
-     No startStone. <snapshot-file-path> required.
+     No startStone. <snapshot-file-path> required. Please read the 'How to Restore from 
+     Backup' section of the System Administration manual
+     (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.
 
@@ -77,7 +90,7 @@ if [ "${noRestart}" = "false" ] ; then
   echo "Copy snapshot and remove tranlogs"
   $GS_HOME/bin/tode newExtent $stoneName $snapshotFile
 
-  # -N option used to ignore the tranlog files during restart
+  # -N option used to ignore tranlog files during restart
   echo "Restarting stone"
   $GS_HOME/bin/startStone -N $stoneName
 else
@@ -90,4 +103,11 @@ else
     usage; exit 1
   fi
   $GS_HOME/bin/tode newExtentForRecovery $stoneName $snapshotFile
+
+  echo "Stone is now ready for recovery. Please read the How to Restore from Backup"
+  echo "section of the manual (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)"
+  echo ""
+  echo "In the simplest case you can just use the '$GS_HOME/startGemstone $stoneName'"
+  echo "and the system will automatically recover from the tranlogs in the stone's "
+  echo "tranlog directory/"
 fi