osCommerce / oscommerce2

catalog/includes/modules/shipping/usps.php

Doc Comments +12 added lines

@@ -167,19 +167,31 @@
       $this->service = $service;
     }
 
+    /**
+     * @param double $pounds
+     */
     function _setWeight($pounds, $ounces=0) {
       $this->pounds = $pounds;
       $this->ounces = $ounces;
     }
 
+    /**
+     * @param string $container
+     */
     function _setContainer($container) {
       $this->container = $container;
     }
 
+    /**
+     * @param string $size
+     */
     function _setSize($size) {
       $this->size = $size;
     }
 
+    /**
+     * @param string $machinable
+     */
     function _setMachinable($machinable) {
       $this->machinable = $machinable;
     }

catalog/install/includes/functions/database.php

Doc Comments +3 added lines

@@ -162,6 +162,9 @@
       return $link;
     }
 
+    /**
+     * @param string $charset
+     */
     function mysqli_set_charset($link, $charset) {
       if ( function_exists('mysql_set_charset') ) {
         return mysql_set_charset($charset, $link);

catalog/admin/includes/functions/html_output.php

Doc Comments +25 added lines

@@ -109,6 +109,9 @@ 
 ////
 // The HTML form submit button wrapper function
 // Outputs a button in the selected language
+  /**
+   * @param string $image
+   */
   function tep_image_submit($image, $alt = '', $parameters = '') {
     global $language;
 
@@ -176,6 +179,9 @@ 
 
 ////
 // Output a form
+  /**
+   * @param string $name
+   */
   function tep_draw_form($name, $action, $parameters = '', $method = 'post', $params = '') {
     $form = '<form name="' . tep_output_string($name) . '" action="';
     if (tep_not_null($parameters)) {
@@ -238,6 +244,9 @@ 
 
 ////
 // Output a selection field - alias function for tep_draw_checkbox_field() and tep_draw_radio_field()
+  /**
+   * @param string $type
+   */
   function tep_draw_selection_field($name, $type, $value = '', $checked = false, $compare = '') {
     global $HTTP_GET_VARS, $HTTP_POST_VARS;
 
@@ -256,12 +265,18 @@ 
 
 ////
 // Output a form checkbox field
+  /**
+   * @param string $name
+   */
   function tep_draw_checkbox_field($name, $value = '', $checked = false, $compare = '') {
     return tep_draw_selection_field($name, 'checkbox', $value, $checked, $compare);
   }
 
 ////
 // Output a form radio field
+  /**
+   * @param string $name
+   */
   function tep_draw_radio_field($name, $value = '', $checked = false, $compare = '') {
     return tep_draw_selection_field($name, 'radio', $value, $checked, $compare);
   }
@@ -269,6 +284,10 @@ 
 ////
 // Output a form textarea field
 // The $wrap parameter is no longer used in the core xhtml template
+  /**
+   * @param string $name
+   * @param string|false $wrap
+   */
   function tep_draw_textarea_field($name, $wrap, $width, $height, $text = '', $parameters = '', $reinsert_value = true) {
     global $HTTP_GET_VARS, $HTTP_POST_VARS;
 
@@ -365,6 +384,12 @@ 
 
 ////
 // Output a jQuery UI Button
+  /**
+   * @param string $title
+   * @param string $icon
+   * @param string $link
+   * @param string $priority
+   */
   function tep_draw_button($title = null, $icon = null, $link = null, $priority = null, $params = null) {
     static $button_counter = 1;
 

catalog/admin/includes/functions/sessions.php

Doc Comments +9 added lines

@@ -103,6 +103,9 @@ 
     return session_start();
   }
 
+  /**
+   * @param string $variable
+   */
   function tep_session_register($variable) {
     if (PHP_VERSION < 4.3) {
       return session_register($variable);
@@ -117,6 +120,9 @@ 
     return false;
   }
 
+  /**
+   * @param string $variable
+   */
   function tep_session_is_registered($variable) {
     if (PHP_VERSION < 4.3) {
       return session_is_registered($variable);
@@ -125,6 +131,9 @@ 
     }
   }
 
+  /**
+   * @param string $variable
+   */
   function tep_session_unregister($variable) {
     if (PHP_VERSION < 4.3) {
       return session_unregister($variable);

catalog/admin/includes/modules/security_check/extended/admin_backup_directory_listing.php

Doc Comments +3 added lines

@@ -32,6 +32,9 @@
       return MODULE_SECURITY_CHECK_EXTENDED_ADMIN_BACKUP_DIRECTORY_LISTING_HTTP_200;
     }
 
+    /**
+     * @param null|string $url
+     */
     function getHttpRequest($url) {
       global $HTTP_SERVER_VARS;
 

catalog/admin/includes/modules/security_check/extended/admin_backup_file.php

Doc Comments +3 added lines

@@ -66,6 +66,9 @@
       return MODULE_SECURITY_CHECK_EXTENDED_ADMIN_BACKUP_FILE_HTTP_200;
     }
 
+    /**
+     * @param null|string $url
+     */
     function getHttpRequest($url) {
       global $HTTP_SERVER_VARS;
 

catalog/includes/classes/email.php

Doc Comments +6 added lines

@@ -82,6 +82,7 @@ 
  * it. This can then be given as the first
  * argument of the the functions
  * add_html_image() or add_attachment().
+ * @param string $filename
  */
 
     function get_file($filename) {
@@ -153,6 +154,7 @@ 
  * Adds a html part to the mail.
  * Also replaces image names with
  * content-id's.
+ * @param string $text
  */
 
     function add_html($html, $text = NULL, $images_dir = NULL) {
@@ -165,6 +167,7 @@ 
 /**
  * Adds an image to the list of embedded
  * images.
+ * @param string $file
  */
 
     function add_html_image($file, $name = '', $c_type='application/octet-stream') {
@@ -239,6 +242,9 @@ 
 
 /* HPDL PHP3 */
 //    function &add_alternative_part(&$obj) {
+    /**
+     * @param null|mime $obj
+     */
     function add_alternative_part(&$obj) {
       $params['content_type'] = 'multipart/alternative';
 

catalog/includes/classes/language.php

Doc Comments +3 added lines

@@ -70,6 +70,9 @@
       $this->set_language($lng);
     }
 
+    /**
+     * @param string $language
+     */
     function set_language($language) {
       if ( (tep_not_null($language)) && (isset($this->catalog_languages[$language])) ) {
         $this->language = $this->catalog_languages[$language];

catalog/includes/classes/passwordhash.php

Doc Comments +16 added lines

@@ -35,6 +35,10 @@ 
 	var $portable_hashes;
 	var $random_state;
 
+	/**
+	 * @param integer $iteration_count_log2
+	 * @param boolean $portable_hashes
+	 */
 	function PasswordHash($iteration_count_log2, $portable_hashes)
 	{
 		$this->itoa64 = './0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
@@ -84,6 +88,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param integer $count
+	 */
 	function encode64($input, $count)
 	{
 		$output = '';
@@ -107,6 +114,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_private($input)
 	{
 		$output = '$P$';
@@ -155,6 +165,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_extended($input)
 	{
 		$count_log2 = min($this->iteration_count_log2 + 8, 24);
@@ -173,6 +186,9 @@ 
 		return $output;
 	}
 
+	/**
+	 * @param string $input
+	 */
 	function gensalt_blowfish($input)
 	{
 		# This one needs to use a different order of characters and a