Add a DocBlock header and added some usage comments.

git-svn-id: http://svn.cleancode.org/svn/pickles@73 4d10bc64-7434-11dc-a737-d2d0f8310089

scripts/pickle

@@ -1,6 +1,36 @@
 #!/usr/bin/php -f
 <?php
 
+/**
+ * PICKLES Scaffolding Generator (to pickle)
+ *
+ * This is the file that you include on the page you're instantiating the
+ * controller from (typically index.php).  The path to the PICKLES code base
+ * is established as well as the path that Smarty will use to store the
+ * compiled pages.
+ *
+ * PICKLES is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation, either version 3 of
+ * the License, or (at your option) any later version.
+ *
+ * PICKLES is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with PICKLES.  If not, see
+ * <http://www.gnu.org/licenses/>.
+ *
+ * @author    Joshua John Sherman <josh@phpwithpickles.org>
+ * @copyright Copyright 2007, 2008 Joshua John Sherman
+ * @link      http://phpwithpickles.org
+ * @license   http://www.gnu.org/copyleft/lesser.html
+ * @package   PICKLES
+ * @usage     ./pickle /path/to/new/site
+ */
+
 $error = null;
 
 $path = isset($argv[1]) ? $argv[1] . (substr($path, -1, 1) != '/' ? '/' : '') : './';