From 5f250da5fa75b304bb223cfb92c0f05e4c03fd0b Mon Sep 17 00:00:00 2001
From: scorphus <scorphus>
Date: Tue, 20 Nov 2007 02:50:07 +0000
Subject: [PATCH] Fixing some missing/wrong docblocks

---
 .../phpeclipse/phpmanual/views/PHPManualView.java  |   30 ++++++++++++--------
 1 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/net.sourceforge.phpeclipse.phpmanual/src/net/sourceforge/phpeclipse/phpmanual/views/PHPManualView.java b/net.sourceforge.phpeclipse.phpmanual/src/net/sourceforge/phpeclipse/phpmanual/views/PHPManualView.java
index fe2cace..84b5f58 100644
--- a/net.sourceforge.phpeclipse.phpmanual/src/net/sourceforge/phpeclipse/phpmanual/views/PHPManualView.java
+++ b/net.sourceforge.phpeclipse.phpmanual/src/net/sourceforge/phpeclipse/phpmanual/views/PHPManualView.java
@@ -86,8 +86,7 @@ public class PHPManualView extends ViewPart implements ISelectionListenerWithAST
 	}
 
 	/**
-	 * This is a callback that will allow us
-	 * to create the viewer and initialize it.
+	 * Initializes the view
 	 */
 	public void createPartControl(Composite parent) {
 		browser = new Browser(parent, SWT.NONE);
@@ -123,13 +122,18 @@ public class PHPManualView extends ViewPart implements ISelectionListenerWithAST
 		}
 	}
 
-	private void showReference(final String occurrence) {
-		System.out.println("Show reference for " + occurrence);
+	/**
+	 * Updates the browser with the reference page for a given function
+	 * 
+	 * @param funcName Function name
+	 */
+	private void showReference(final String funcName) {
+		System.out.println("Show reference for " + funcName);
 		new Thread(new Runnable() {
 			public void run() {
 				Display.getDefault().asyncExec(new Runnable() {
 					public void run() {
-						String html = getHtmlSource(occurrence);
+						String html = getHtmlSource(funcName);
 						browser.setText(html);
 					}
 				});
@@ -187,9 +191,9 @@ public class PHPManualView extends ViewPart implements ISelectionListenerWithAST
 	}
 
 	/**
-	 * Looks for the function's reference page inside the doc.zip file and
-	 * returns a filtered HTML source of it
-	 * @param funcName Function name
+	 * Filters the function's reference page extracting only parts of it
+	 * 
+	 * @param source HTML source of the reference page
 	 * @return HTML source of reference page
 	 */
 	private String filterHtmlSource(String source) {
@@ -224,8 +228,9 @@ public class PHPManualView extends ViewPart implements ISelectionListenerWithAST
 	}
 
 	/**
-	 * Looks for the function's reference page inside the doc.zip file and
-	 * returns a filtered HTML source of it
+	 * Reads the template that defines the style of the reference page
+	 * shown inside the view's browser
+	 * 
 	 * @param funcName Function name
 	 * @return HTML source of reference page
 	 */
@@ -261,8 +266,9 @@ public class PHPManualView extends ViewPart implements ISelectionListenerWithAST
 	}
 
 	/**
-	 * Looks for the function's reference page inside the doc.zip file and
-	 * returns a filtered HTML source of it
+	 * Looks for the function's reference page inside the doc.zip file
+	 * and returns a filtered HTML source of it embedded in the template
+	 *  
 	 * @param funcName Function name
 	 * @return HTML source of reference page
 	 */
-- 
1.7.1