From 83eb765fefd8bd1eba6701f08eb9d7a80f26d455 Mon Sep 17 00:00:00 2001
From: Colin Kuskie <colink@perldreamer.com>
Date: Thu, 1 Mar 2007 22:37:25 +0000
Subject: [PATCH] add docs for fixing missing thumbnails and add the --help
 switch to the thumbnailer script

---
 docs/changelog/7.x.x.txt |  2 ++
 docs/gotcha.txt          | 10 ++++++++++
 sbin/thumbnailer.pl      |  9 +++++++--
 3 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/docs/changelog/7.x.x.txt b/docs/changelog/7.x.x.txt
index fe9d60263..f5f225006 100644
--- a/docs/changelog/7.x.x.txt
+++ b/docs/changelog/7.x.x.txt
@@ -2,6 +2,8 @@
  - fix: Fixing bad link on the Event page to the search engine. Added a new
    Event template variable called urlSearch to handle it.  (perlDreamer Consulting, LLC)
  - fix: Set default groupIdEditEvent to groupIdEdit during upgrade (perlDreamer Consulting, LLC)
+ - Rewrote the sbin/thumbnail.pl script and added an option to only create
+   thumbnails for images without thumbnails. (perlDreamer Consulting, LLC)
 
 7.3.11
  - Added an option for enabling coverage tests to testCodebase.pl.
diff --git a/docs/gotcha.txt b/docs/gotcha.txt
index e5dcb7f2b..20d14eb33 100644
--- a/docs/gotcha.txt
+++ b/docs/gotcha.txt
@@ -7,6 +7,16 @@ upgrading from one version to the next, or even between multiple
 versions. Be sure to heed the warnings contained herein as they will
 save you many hours of grief.
 
+7.3.12
+--------------------------------------------------------------------
+
+ * The sbin/thumbnailer.pl script was almost completely rewritten.
+   It now accepts a script to only thumbnail things that do not
+   already have thumbnails, to help compensate for problems with
+   the RTE Collateral Image manager upload/thumbnail bug.
+   Run the script with no arguments to get a summary of the new
+   usage.
+
 7.3.11
 --------------------------------------------------------------------
 
diff --git a/sbin/thumbnailer.pl b/sbin/thumbnailer.pl
index 488198302..d2539a84e 100644
--- a/sbin/thumbnailer.pl
+++ b/sbin/thumbnailer.pl
@@ -23,21 +23,26 @@ use WebGUI::Utility;
 
 my $thumbnailSize;
 my $onlyMissingThumbnails;
+my $help;
 
 my $path = shift @ARGV;
 
 my $ok = GetOptions(
         'size=i'=>\$thumbnailSize,
         'missing'=>\$onlyMissingThumbnails,
+        'help'=>\$help,
 );
 
-unless ($path ne "" and $ok){
+if ($help || ($path && $ok) ) {
   print <<USAGE;
 Usage: perl $0 <uploadsPath> [--size=thumbnailSize] [--missing]
 
 uploadsPath is the complete path to your uploads directory
---size allows you to override the default thumbnail size of 50
+
+--size=thumbSize allows you to override the default thumbnail size of 50.
+
 --missing says to only create thumbnails for images that are missing thumbnails.
+
 USAGE
 
 exit 0;