From 31d3208c7d6ba5e3f62ade1cf3a836f8803da756 Mon Sep 17 00:00:00 2001
From: rob <rob@c91229c3-7414-0410-bfa2-8a42b809f60b>
Date: Tue, 10 Dec 2002 09:36:08 +0000
Subject: [PATCH] Added php doc comments to file

---
 browse.php | 74 +++++++++++++++++++++++++++++++++++++++++++-------------------------------
 1 file changed, 43 insertions(+), 31 deletions(-)

diff --git a/browse.php b/browse.php
index f8fc1ed..72f4995 100755
--- a/browse.php
+++ b/browse.php
@@ -1,6 +1,8 @@
 <?php
-/*
+/**
  * browse.php -- Browse page
+ * 
+ * Browse a list of files/folders
  *
  * Copyright (c) 1999-2002 The Owl Project Team
  * Licensed under the GNU GPL. For full terms see the file COPYING.
@@ -22,7 +24,7 @@ if(!isset($sortname)) $sortname = "ASC";
 // Daphne change
 if(!isset($sortver)) $sortver = "ASC, minor_revision ASC";
 if(!isset($sortcheckedout)) $sortcheckedout = "ASC";
-// end daphne change
+// end Daphne change
 if(!isset($sortfilename)) $sortfilename = "DESC";
 if(!isset($sortsize)) $sortsize = "DESC";
 if(!isset($sortposted)) $sortposted = "DESC";
@@ -67,6 +69,7 @@ switch ($order) {
 // END 496814 Column Sorts are not persistant
 
 
+//if the user does not have permission to view the folder
 if(check_auth($parent, "folder_view", $userid) != "1") {
  	printError($lang_nofolderaccess,"");
 	exit;
@@ -123,40 +126,47 @@ if ($expand == 1) {
 	print("\t\t<HR WIDTH=$default->table_collapse_width>\n");
 }
 
-//
-// functions to create/show the links to be sorted on
-//
-function show_link($column,$sortname,$sortvalue,$order,$sess,$expand,$parent,$lang_title,$url) {
+/**
+* Creates links that can be sorted
+*
+* @param $column	current column
+* @param $sortname
+* @param $sortvalue	ASC or DESC
+* @param $order		column to order by
+* @param $sess
+* @param $expand
+* @param $parent
+* @param $lang_title
+* @param $url
+*/
 
-                if ($sortvalue == "ASC")
-                {
-                     print("\t\t\t\t<TD align=left><A HREF='browse.php?sess=$sess&expand=$expand&parent=$parent&order=$column&$sortname=DESC' STYLE='toplink'>$lang_title");
-                     if ($order == $column)
-                     {
-                       print("<img border='0' src='$url/graphics/asc.gif' width='16' height='16'></A></TD>");
-                     }
-                     else
-                     {
-                       print("</A></TD>");
-                     }
+function show_link($column,$sortname,$sortvalue,$order,$sess,$expand,$parent,$lang_title,$url) {
 
-                }
-                else
-                {
-                     print("\t\t\t\t<TD align=left><A HREF='browse.php?sess=$sess&expand=$expand&parent=$parent&order=$column&$sortname=ASC' STYLE='toplink'>$lang_title");
-                     if ($order == $column)
-                     {
-                       print("<img border='0' src='$url/graphics/desc.gif' width='16' height='16'></A></TD>");
-                     }
-                     else
-                     {
-                       print("</A></TD>");
-                     }
-                }
+	if ($sortvalue == "ASC") {
+	     print("\t\t\t\t<TD align=left><A HREF='browse.php?sess=$sess&expand=$expand&parent=$parent&order=$column&$sortname=DESC' STYLE='toplink'>$lang_title");
+	     if ($order == $column)
+	     {
+	       print("<img border='0' src='$url/graphics/asc.gif' width='16' height='16'></A></TD>");
+	     }
+	     else
+	     {
+	       print("</A></TD>");
+	     }
+	
+	}
+	else {
+	     print("\t\t\t\t<TD align=left><A HREF='browse.php?sess=$sess&expand=$expand&parent=$parent&order=$column&$sortname=ASC' STYLE='toplink'>$lang_title");
+	     if ($order == $column)
+	     {
+	       print("<img border='0' src='$url/graphics/desc.gif' width='16' height='16'></A></TD>");
+	     }
+	     else {
+	       print("</A></TD>");
+	     }
+	}
 }
 
 
-
 if ($expand == 1) {
 	print("\t\t\t<TABLE WIDTH=$default->table_expand_width BORDER=$default->table_border><TR BGCOLOR='$default->table_header_bg'>");
         show_link("name","sortname",$sortname,$order,$sess,$expand,$parent,$lang_title,$default->owl_root_url);
@@ -209,7 +219,9 @@ if ($order == "creatorid") {
 //**********************
 
 while($sql->next_record()) {
+	//if the current user has a restricted view
 	if($default->restrict_view == 1) {
+		//if the current user does not have permission to view the folder
 		if(!check_auth($sql->f("id"), "folder_view", $userid)) 
 			continue;
 	}
--
libgit2 0.21.4