Inline documentation changes

git-svn-id: https://phpexcel.svn.codeplex.com/svn/trunk@85955 2327b42d-5241-43d6-9e2a-de5ac946f064

Classes/PHPExcel/Reader/Excel2003XML.php

@@ -166,6 +166,7 @@ class PHPExcel_Reader_Excel2003XML implements PHPExcel_Reader_IReader
 	 *
 	 *	@param 	string 		$pFileName
 	 *	@return 	boolean
+	 *	@throws Exception
 	 */
 	public function canRead($pFilename)
 	{

Classes/PHPExcel/Reader/Excel2007.php

@@ -181,26 +181,27 @@ class PHPExcel_Reader_Excel2007 implements PHPExcel_Reader_IReader
 	 *
 	 *	@param 	string 		$pFileName
 	 *	@return 	boolean
+	 *	@throws Exception
 	 */
 	public function canRead($pFilename)
 	{
-		// Check if zip class exists
-		if (!class_exists('ZipArchive')) {
-			return false;
-		}
-
 		// Check if file exists
 		if (!file_exists($pFilename)) {
 			throw new Exception("Could not open " . $pFilename . " for reading! File does not exist.");
 		}
 
+		// Check if zip class exists
+		if (!class_exists('ZipArchive')) {
+			throw new Exception("ZipArchive library is not enabled");
+		}
+
 		$xl = false;
 		// Load file
 		$zip = new ZipArchive;
 		if ($zip->open($pFilename) === true) {
 			// check if it is an OOXML archive
 			$rels = simplexml_load_string($this->_getFromZipArchive($zip, "_rels/.rels"));
-			if ($rels) {
+			if ($rels !== false) {
 				foreach ($rels->Relationship as $rel) {
 					switch ($rel["Type"]) {
 						case "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument":

Classes/PHPExcel/Reader/Gnumeric.php

@@ -183,19 +183,20 @@ class PHPExcel_Reader_Gnumeric implements PHPExcel_Reader_IReader
 	 *
 	 *	@param 	string 		$pFileName
 	 *	@return 	boolean
+	 *	@throws Exception
 	 */
 	public function canRead($pFilename)
 	{
-		// Check if gzlib functions are available
-		if (!function_exists('gzread')) {
-			return false;
-		}
-
 		// Check if file exists
 		if (!file_exists($pFilename)) {
 			throw new Exception("Could not open " . $pFilename . " for reading! File does not exist.");
 		}
 
+		// Check if gzlib functions are available
+		if (!function_exists('gzread')) {
+			throw new Exception("gzlib library is not enabled");
+		}
+
 		// Read signature data (first 3 bytes)
 		$fh = fopen($pFilename, 'r');
 		$data = fread($fh, 2);

Classes/PHPExcel/Reader/OOCalc.php

@@ -173,19 +173,20 @@ class PHPExcel_Reader_OOCalc implements PHPExcel_Reader_IReader
 	 *
 	 *	@param 	string 		$pFileName
 	 *	@return 	boolean
+	 *	@throws Exception
 	 */
 	public function canRead($pFilename)
 	{
-		// Check if zip class exists
-		if (!class_exists('ZipArchive')) {
-			return false;
-		}
-
 		// Check if file exists
 		if (!file_exists($pFilename)) {
 			throw new Exception("Could not open " . $pFilename . " for reading! File does not exist.");
 		}
 
+		// Check if zip class exists
+		if (!class_exists('ZipArchive')) {
+			throw new Exception("ZipArchive library is not enabled");
+		}
+
 		// Load file
 		$zip = new ZipArchive;
 		if ($zip->open($pFilename) === true) {

Classes/PHPExcel/Reader/SYLK.php

@@ -91,6 +91,7 @@ class PHPExcel_Reader_SYLK implements PHPExcel_Reader_IReader
 	 *
 	 *	@param 	string 		$pFileName
 	 *	@return 	boolean
+	 *	@throws Exception
 	 */
 	public function canRead($pFilename)
 	{