PHPDoc & code cleanup

sources/application/UI/Component/Html/Html.php

@@ -35,7 +35,7 @@ class Html extends UIBlock
 	const BLOCK_CODE = 'ibo-html';
 	const HTML_TEMPLATE_REL_PATH = 'components/html/layout';
 
-	/** @var string $sHtml */
+	/** @var string $sHtml The raw HTML, must be already sanitized */
 	protected $sHtml;
 
 	/**
@@ -51,6 +51,8 @@ class Html extends UIBlock
 	}
 
 	/**
+	 * Return the raw HTML, should have been sanitized
+	 *
 	 * @return string
 	 */
 	public function GetHtml()
@@ -59,7 +61,10 @@ class Html extends UIBlock
 	}
 
 	/**
+	 * Set the raw HTML, must be already sanitized
+	 *
 	 * @param string $sHtml
+	 *
 	 * @return $this
 	 */
 	public function SetHtml($sHtml)

sources/application/UI/Layout/PageContent/PageContentFactory.php

@@ -57,6 +57,8 @@ class PageContentFactory
 		$oLayout = new PageContentWithSideContent();
 
 		// Add object details layout
+		// TODO
+
 		// Add object activity layout
 		$oActivityPanel = ActivityPanelFactory::MakeForObjectDetails($oObject);
 		$oLayout->AddSideBlock($oActivityPanel);

sources/application/UI/UIBlock.php

@@ -149,7 +149,7 @@ abstract class UIBlock implements iUIBlock
 
 	/**
 	 * @inheritDoc
-	 * @return \Combodo\iTop\Application\UI\UIBlock[]
+	 * @return \Combodo\iTop\Application\UI\iUIBlock[]
 	 */
 	public function GetSubBlocks()
 	{

sources/application/UI/iUIBlock.php

@@ -80,6 +80,7 @@ interface iUIBlock
 
 	/**
 	 * Return an array iUIBlock embedded in this iUIBlock
+	 * Must be an associative array (<BLOCK_ID> => <BLOCK_INSTANCE>)
 	 *
 	 * @return \Combodo\iTop\Application\UI\iUIBlock[]
 	 */