MINOR documentation

git-svn-id: svn://svn.silverstripe.com/silverstripe/open/modules/sapphire/trunk@73232 467b73ca-7a2a-4603-9d3b-597d59a354a9

email/Email.php

@@ -233,6 +233,9 @@ class Email extends ViewableData {
 	/**
 	 * Add a custom header to this value.
 	 * Useful for implementing all those cool features that we didn't think of.
+	 * 
+	 * @param string $headerName
+	 * @param string $headerValue
 	 */
 	public function addCustomHeader($headerName, $headerValue) {
 		if($headerName == 'Cc') $this->cc = $headerValue;

email/Mailer.php

@@ -1,21 +1,21 @@
 <?php
 /**
+ * Mailer objects are responsible for actually sending emails.
+ * The default Mailer class will use PHP's mail() function.
+ * 
  * @package sapphire
  * @subpackage email
  */
-
-/**
- * Mailer objects are responsible for actually sending emails.
- * The default Mailer class will use PHP's mail() fun
- * However, it 
- * One Email::set_mailer();
- * 
- * @TODO complete the description above
- */
 class Mailer extends Object {
 	/**
 	 * Send a plain-text email.
 	 *  
+	 * @param string $to
+	 * @param string $from
+	 * @param string §subject
+	 * @param string $plainContent
+	 * @param bool $attachedFiles
+	 * @param array $customheaders
 	 * @return bool
 	 */
 	function sendPlain($to, $from, $subject, $plainContent, $attachedFiles = false, $customheaders = false) {
@@ -319,7 +319,7 @@ function wrapImagesInline_rewriter($url) {
 }
 
 /*
- * Combine headers w/ the body into a single string
+ * Combine headers w/ the body into a single string.
  */
 function processHeaders($headers, $body = false) {
 	$res = '';