From 0868e0642f694bf5c08951f67f5a4b7eadde041a Mon Sep 17 00:00:00 2001
From: Jacek Kowalski <Jacek@jacekk.info>
Date: Thu, 05 Sep 2013 21:22:22 +0000
Subject: [PATCH] Zmiana numeru wersji na 2.6, testy jednostkowe niektórych klas (PHPUnit), dodanych wiele komentarzy dotyczących metod oraz atrybutów (Doxygen), aktualizacja instrukcji instalacji i aktualizacji.

---
 class/BotMsg.php |   46 +++++++++++++++++++++++++++++++++++++++++-----
 1 files changed, 41 insertions(+), 5 deletions(-)

diff --git a/class/BotMsg.php b/class/BotMsg.php
index 54c6afa..bf58ce9 100644
--- a/class/BotMsg.php
+++ b/class/BotMsg.php
@@ -1,11 +1,33 @@
 <?php
 class BotMsgException extends Exception {}
+
+/**
+ * Interfejs dla klas przetwarzających wiadomości wychodzące
+ * do formatu właściwego dla danej sieci.
+ */
 interface BotMsgInterface {
+	/**
+	 * Konstruktor
+	 * @param BotMsg $msg Wiadomość do przetworzenia
+	 */
 	function __construct(BotMsg $msg);
+	/**
+	 * Zwraca przetworzoną wiadomość
+	 * @return string Wiadomość po przetworzeniu
+	 */
 	function __toString();
+	
+	/**
+	 * Podaje na wyjście (np. za pomocą echo) wiadomość w formacie
+	 * odpowiednim dla danego API, uwzględniając nagłówki HTTP
+	 * i inne konieczne elementy.
+	 */
 	function sendPullResponse();
 }
 
+/**
+ * Klasa reprezentująca wiadomość wychodzącą.
+ */
 class BotMsg {
 	private $beautiful = TRUE;
 	private $parser = NULL;
@@ -14,14 +36,28 @@
 	private $raw = '';
 	
 	/**
-	 * Włącza lub wyłącza "upiększanie" konwertowanej do czystego tekstu wiadomości, np.:
-	 * <b>abc</b> zamieniane jest na *abc*
-	 * <h1>efg</h1> przechodzi w = efg =
+	 * Włącza lub wyłącza "upiększanie" konwertowanej
+	 * do czystego tekstu ({@link BotMsg::getText()}) wiadomości, np.:
+	 *
+	 * &lt;b&gt;abc&lt;/b&gt; zamieniane jest na \*abc\*
+	 *
+	 * &lt;h1&gt;efg&lt;h1&gt; przechodzi w = efg =
+	 *
 	 * Domyślnie włączone
 	 * @param bool $set Ustawienie "upiększania"
 	 */
+	function setBeautiful($set = FALSE) {
+		if($this->beautiful != $set) {
+			$this->text = $this->html = $this->parser = NULL;
+			$this->beautiful = (bool)$set;
+		}
+	}
+	
+	/**
+	 * @deprecated Zastąpiono funkcją {@link BotMsg::setBeautiful()}
+	 */
 	function beautifulText($set = FALSE) {
-		$this->beautiful = (bool)$set;
+		$this->setBeautiful($set);
 	}
 	
 	/**
@@ -204,7 +240,7 @@
 			}
 		}
 		
-		return $return;
+		return trim($return);
 	}
 	
 	private function parseHTMLDOM($dom) {

--
Gitblit v1.9.1