From bcbdfe2a13a77393d1779ce17d2726bb7f53ac71 Mon Sep 17 00:00:00 2001
From: Ingo Schommer <ingo@silverstripe.com>
Date: Wed, 4 Feb 2009 20:18:12 +0000
Subject: [PATCH] MINOR Documentation

git-svn-id: svn://svn.silverstripe.com/silverstripe/open/modules/cms/trunk@71387 467b73ca-7a2a-4603-9d3b-597d59a354a9
---
 code/staticpublisher/FilesystemPublisher.php     | 8 +++++---
 code/staticpublisher/RsyncMultiHostPublisher.php | 8 ++++++++
 code/staticpublisher/StaticPublisher.php         | 5 ++++-
 3 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/code/staticpublisher/FilesystemPublisher.php b/code/staticpublisher/FilesystemPublisher.php
index 5852bd54..bc818e7a 100644
--- a/code/staticpublisher/FilesystemPublisher.php
+++ b/code/staticpublisher/FilesystemPublisher.php
@@ -2,6 +2,11 @@
 
 /**
  * Usage: Object::add_extension("SiteTree", "FilesystemPublisher('../static-folder/')")
+ *
+ * @see http://doc.silverstripe.com/doku.php?id=staticpublisher
+ * 
+ * @package cms
+ * @subpackage publishers
  */
 class FilesystemPublisher extends StaticPublisher {
 	protected $destFolder;
@@ -136,9 +141,6 @@ class FilesystemPublisher extends StaticPublisher {
 		}
 
 		if(self::$static_base_url) Director::setBaseURL(null);
-
-		//Debug::show(array_keys($files));
-		//Debug::show(array_keys($missingFiles));
 		
 		$base = "../$this->destFolder";
 		foreach($files as $file) {
diff --git a/code/staticpublisher/RsyncMultiHostPublisher.php b/code/staticpublisher/RsyncMultiHostPublisher.php
index 2f7b2e51..e20b5842 100644
--- a/code/staticpublisher/RsyncMultiHostPublisher.php
+++ b/code/staticpublisher/RsyncMultiHostPublisher.php
@@ -3,6 +3,11 @@
 /**
  * This static publisher can be used to deploy static content to multiple hosts, by generating the cache files locally and then rsyncing then to
  * each destination box.  This can be used to set up a load-balanced collection of static servers.
+ * 
+ * @see http://doc.silverstripe.com/doku.php?id=staticpublisher
+ *
+ * @package cms
+ * @subpackage publishers
  */
 class RsyncMultiHostPublisher extends FilesystemPublisher {
 	/**
@@ -12,6 +17,9 @@ class RsyncMultiHostPublisher extends FilesystemPublisher {
 	
 	/**
 	 * Set the targets to publish to.
+	 * If target is an scp-style remote path, no password is accepted - we assume key-based authentication to be set up on the application server
+	 * initiating the publication.
+	 * 
 	 * @param $targets An array of targets to publish to.  These can either be local file names, or scp-style targets, in the form "user@server:path"
 	 */
 	static function set_targets($targets) {
diff --git a/code/staticpublisher/StaticPublisher.php b/code/staticpublisher/StaticPublisher.php
index 1b251658..793d491b 100644
--- a/code/staticpublisher/StaticPublisher.php
+++ b/code/staticpublisher/StaticPublisher.php
@@ -1,5 +1,8 @@
 <?php
-
+/**
+ * @package cms
+ * @subpackage publishers
+ */
 abstract class StaticPublisher extends DataObjectDecorator {
 	/**
 	 * Defines whether to output information about publishing or not. By