adamjakab / SuiteCRM

include/nusoap/nusoap.php

Doc Comments +25 added lines, -23 removed lines

@@ -552,7 +552,7 @@ 
 	/**
 	* gets the current debug data for this instance
 	*
-	* @return   debug data
+	* @return   string data
 	* @access   public
 	*/
 	function &getDebug() {
@@ -565,7 +565,7 @@ 
 	* gets the current debug data for this instance as an XML comment
 	* this may change the contents of the debug data
 	*
-	* @return   debug data as an XML comment
+	* @return   string data as an XML comment
 	* @access   public
 	*/
 	function &getDebugAsXMLComment() {
@@ -596,7 +596,7 @@ 
 	/**
 	* returns error string if present
 	*
-	* @return   mixed error string or false
+	* @return   string|false error string or false
 	* @access   public
 	*/
 	function getError(){
@@ -609,7 +609,7 @@ 
 	/**
 	* sets error string
 	*
-	* @return   boolean $string error string
+	* @return   boolean|null $string error string
 	* @access   private
 	*/
 	function setError($str){
@@ -1045,7 +1045,7 @@ 
     * returns false, if not prefixed
     *
     * @param string $str The prefixed string
-    * @return mixed The prefix or false if there is no prefix
+    * @return string|false The prefix or false if there is no prefix
     * @access public
     */
 	function getPrefix($str){
@@ -1076,7 +1076,7 @@ 
     * or false if no prefixes registered for the given namespace
     *
     * @param string $ns The namespace
-    * @return mixed The prefix, false if the namespace has no prefixes
+    * @return string The prefix, false if the namespace has no prefixes
     * @access public
     */
 	function getPrefixFromNamespace($ns) {
@@ -1145,7 +1145,7 @@ 
 *
 * @param    int $timestamp Unix time stamp
 * @param	boolean $utc Whether the time stamp is UTC or local
-* @return	mixed ISO 8601 date string or false
+* @return	string|false ISO 8601 date string or false
 * @access   public
 */
 function timestamp_to_iso8601($timestamp,$utc=true){
@@ -1484,7 +1484,7 @@ 
     * @param string $faultcode (SOAP-ENV:Client | SOAP-ENV:Server)
     * @param string $faultactor only used when msg routed between multiple actors
     * @param string $faultstring human readable error message
-    * @param mixed $faultdetail detail, typically a string or array of string
+    * @param string $faultdetail detail, typically a string or array of string
 	*/
 	function nusoap_fault($faultcode,$faultactor='',$faultstring='',$faultdetail=''){
 		parent::nusoap_base();
@@ -2527,7 +2527,7 @@ 
     * returns a sample serialization of a given type, or false if no type by the given name
     *
     * @param string $type name of type
-    * @return mixed
+    * @return string|false
     * @access public
     * @deprecated
     */
@@ -2970,7 +2970,7 @@ 
 	*
 	* @param    string $name optional name
 	* @param    mixed $type optional type name
-	* @param	mixed $value optional value
+	* @param	integer $value optional value
 	* @param	mixed $element_ns optional namespace of value
 	* @param	mixed $type_ns optional namespace of type
 	* @param	mixed $attributes associative array of attributes to add to element serialization
@@ -3381,10 +3381,6 @@ 
 	/**
 	* establish an HTTP connection
 	*
-	* @param    integer $timeout set connection timeout in seconds
-	* @param	integer $response_timeout set response timeout in seconds
-	* @return	boolean true if connected, false if not
-	* @access   private
 	*/
 	function connect($connection_timeout=0,$response_timeout=30){
 	  	// For PHP 4.3 with OpenSSL, change https scheme to ssl, then treat like
@@ -3943,7 +3939,7 @@ 
 	*
 	* @param    string $data message data
 	* @param	array $cookies cookies to send
-	* @return	boolean	true if OK, false if problem
+	* @return	boolean|null	true if OK, false if problem
 	* @access   private
 	*/
 	function sendRequest($data, $cookies = NULL) {
@@ -4378,7 +4374,7 @@ 
 	 * sets the content-type for the SOAP message to be sent
 	 *
 	 * @param	string $type the content type, MIME style
-	 * @param	mixed $charset character set used for encoding (or false)
+	 * @param	string $charset character set used for encoding (or false)
 	 * @access	public
 	 */
 	function setContentType($type, $charset = false) {
@@ -4411,6 +4407,10 @@ 
 	/*
 	 * TODO: allow a Set-Cookie string to be parsed into multiple cookies
 	 */
+
+	/**
+	 * @param string $cookie_str
+	 */
 	function parseCookie($cookie_str) {
 		$cookie_str = str_replace('; ', ';', $cookie_str) . ';';
 		$data = preg_split('/;/', $cookie_str);
@@ -5571,7 +5571,7 @@ 
 	*
 	* @param	array	$headers	The HTTP headers
 	* @param	string	$data		unprocessed request data from client
-	* @return	mixed	value of the message, decoded into a PHP type
+	* @return	false|null	value of the message, decoded into a PHP type
 	* @access   private
 	*/
     function parseRequest($headers, $data) {
@@ -5678,7 +5678,7 @@ 
 	* @param    string $name the name of the PHP function, class.method or class..method
 	* @param    array $in assoc array of input values: key = param name, value = param type
 	* @param    array $out assoc array of output values: key = param name, value = param type
-	* @param	mixed $namespace the element namespace for the method or false
+	* @param	string $namespace the element namespace for the method or false
 	* @param	mixed $soapaction the soapaction for the method or false
 	* @param	mixed $style optional (rpc|document) or false Note: when 'document' is specified, parameter and return wrappers are created for you automatically
 	* @param	mixed $use optional (encoded|literal) or false
@@ -5768,11 +5768,12 @@ 
     * Acts as a flag to enable internal WSDL generation
     *
     * @param string $serviceName, name of the service
-    * @param mixed $namespace optional 'tns' service namespace or false
-    * @param mixed $endpoint optional URL of service endpoint or false
+    * @param string $namespace optional 'tns' service namespace or false
+    * @param string $endpoint optional URL of service endpoint or false
     * @param string $style optional (rpc|document) WSDL style (also specified by operation)
     * @param string $transport optional SOAP transport
     * @param mixed $schemaTargetNamespace optional 'types' targetNamespace for service schema or false
+    * @param string $serviceName
     */
     function configureWSDL($serviceName,$namespace = false,$endpoint = false,$style='rpc', $transport = 'http://schemas.xmlsoap.org/soap/http', $schemaTargetNamespace = false)
     {
@@ -6937,7 +6938,7 @@ 
 	/**
 	* serialize the parsed wsdl
 	*
-	* @param mixed $debug whether to put debug=1 in endpoint URL
+	* @param integer $debug whether to put debug=1 in endpoint URL
 	* @return string serialization of WSDL
 	* @access public
 	*/
@@ -7160,7 +7161,7 @@ 
 	 * @param string $direction (input|output)
 	 * @param mixed $parameters parameter value(s)
 	 * @param string $bindingType (soap|soap12)
-	 * @return mixed parameters serialized as XML or false on error (e.g. operation not found)
+	 * @return false|string parameters serialized as XML or false on error (e.g. operation not found)
 	 * @access public
 	 */
 	function serializeRPCParameters($operation, $direction, $parameters, $bindingType = 'soap') {
@@ -7260,7 +7261,7 @@ 
 	 * @param string $operation operation name
 	 * @param string $direction (input|output)
 	 * @param mixed $parameters parameter value(s)
-	 * @return mixed parameters serialized as XML or false on error (e.g. operation not found)
+	 * @return false|string parameters serialized as XML or false on error (e.g. operation not found)
 	 * @access public
 	 * @deprecated
 	 */
@@ -9804,6 +9805,7 @@ 
 	/**
 	* dynamically creates proxy class code
 	*
+	* @param integer $r
 	* @return   string PHP/NuSOAP code for the proxy class
 	* @access   private
 	*/

include/nusoap/nusoapmime.php

Doc Comments +1 added lines, -1 removed lines

@@ -564,7 +564,7 @@
 	*
 	* @param	array	$headers	The HTTP headers
 	* @param	string	$data		unprocessed request data from client
-	* @return	mixed	value of the message, decoded into a PHP type
+	* @return	false|null	value of the message, decoded into a PHP type
 	* @access   private
 	*/
     function parseRequest($headers, $data) {

include/OutboundEmail/OutboundEmail.php

Doc Comments +5 added lines, -6 removed lines

@@ -134,7 +134,7 @@ 
 	 * override account.
 	 *
 	 * @param unknown_type $user_id
-	 * @return unknown
+	 * @return boolean
 	 */
 	function doesUserOverrideAccountRequireCredentials($user_id)
 	{
@@ -229,7 +229,7 @@ 
 	 * Retrieves a cascading mailer set
 	 * @param object user
 	 * @param string mailer_id
-	 * @return object
+	 * @return OutboundEmail
 	 */
 	function getUserMailerSettings(&$user, $mailer_id='', $ieId='') {
 		$mailer = '';
@@ -267,7 +267,6 @@ 
 	 * their outbound account set to this object.
 	 *
 	 * @param SugarBean $user
-	 * @param string $outbound_id
 	 * @return array
 	 */
 	function getAssociatedInboundAccounts($user)
@@ -291,7 +290,7 @@ 
 	 * Retrieves a cascading mailer set
 	 * @param object user
 	 * @param string mailer_id
-	 * @return object
+	 * @return OutboundEmail
 	 */
 	function getInboundMailerSettings($user, $mailer_id='', $ieId='') {
 		$mailer = '';
@@ -390,7 +389,7 @@ 
 	/**
 	 * Populates this instance
 	 * @param string $id
-	 * @return object $this
+	 * @return OutboundEmail $this
 	 */
 	function retrieve($id) {
 		require_once('include/utils/encryption_utils.php');
@@ -428,7 +427,7 @@ 
 	/**
 	 * Generate values for saving into outbound_emails table
 	 * @param array $keys
-	 * @return array
+	 * @return string
 	 */
 	protected function getValues(&$keys)
 	{

include/parsecsv.lib.php

Doc Comments +15 added lines, -14 removed lines

@@ -188,7 +188,7 @@ 
 	/**
 	 * Parse CSV file or string
 	 * @param   input   CSV file or string
-	 * @return  nothing
+	 * @return  boolean
 	 */
 	function parse ($input = null, $offset = null, $limit = null, $conditions = null) {
 		if ( $input === null ) $input = $this->file;
@@ -213,7 +213,7 @@ 
 	 * @param   data     2D array with data
 	 * @param   append   append current data to end of target CSV if exists
 	 * @param   fields   field names
-	 * @return  true or false
+	 * @return  boolean or false
 	 */
 	function save ($file = null, $data = array(), $append = false, $fields = array()) {
 		if ( empty($file) ) $file = &$this->file;
@@ -228,7 +228,7 @@ 
 	 * @param   data        2D array with data
 	 * @param   fields      field names
 	 * @param   delimiter   delimiter used to separate data
-	 * @return  CSV data using delimiter of choice, or default
+	 * @return  string data using delimiter of choice, or default
 	 */
 	function output ($filename = null, $data = array(), $fields = array(), $delimiter = null) {
 		if ( empty($filename) ) $filename = $this->output_filename;
@@ -262,7 +262,7 @@ 
 	 * @param   search_depth   number of rows to analyze
 	 * @param   preferred      preferred delimiter characters
 	 * @param   enclosure      enclosure character, default is double quote (").
-	 * @return  delimiter character
+	 * @return  string character
 	 */
 	function auto ($file = null, $parse = true, $search_depth = null, $preferred = null, $enclosure = null) {
 
@@ -507,7 +507,7 @@ 
 	 * @param   is_php      if a php die() call should be put on the first
 	 *                      line of the file, this is later ignored when read.
 	 * @param   delimiter   field delimiter to use
-	 * @return  CSV data (text string)
+	 * @return  string data (text string)
 	 */
 	function unparse ( $data = array(), $fields = array(), $append = false , $is_php = false, $delimiter = null) {
 		if ( !is_array($data) || empty($data) ) $data = &$this->data;
@@ -541,7 +541,7 @@ 
 	/**
 	 * Load local file or string
 	 * @param   input   local CSV file
-	 * @return  true or false
+	 * @return  boolean or false
 	 */
 	function load_data ($input = null) {
 		$data = null;
@@ -575,7 +575,7 @@ 
 	 * Validate a row against specified conditions
 	 * @param   row          array with values from a row
 	 * @param   conditions   specified conditions that the row must match
-	 * @return  true of false
+	 * @return  boolean of false
 	 */
 	function _validate_row_conditions ($row = array(), $conditions = null) {
 		if ( !empty($row) ) {
@@ -605,7 +605,7 @@ 
 	 * Validate a row against a single condition
 	 * @param   row          array with values from a row
 	 * @param   condition   specified condition that the row must match
-	 * @return  true of false
+	 * @return  string of false
 	 */
 	function _validate_row_condition ($row, $condition) {
 		$operators = array(
@@ -663,8 +663,8 @@ 
 
 	/**
 	 * Validates if the row is within the offset or not if sorting is disabled
-	 * @param   current_row   the current row number being processed
-	 * @return  true of false
+	 * @param   current_row   integer current row number being processed
+	 * @return  boolean of false
 	 */
 	function _validate_offset ($current_row) {
 		if ( $this->sort_by === null && $this->offset !== null && $current_row < $this->offset ) return false;
@@ -675,7 +675,7 @@ 
 	 * Enclose values if needed
 	 *  - only used by unparse()
 	 * @param   value   string to process
-	 * @return  Processed value
+	 * @return  null|string value
 	 */
 	function _enclose_value ($value = null) {
 		if ( $value !== null && $value != '' ) {
@@ -692,7 +692,7 @@ 
 	/**
 	 * Check file data
 	 * @param   file   local filename
-	 * @return  true or false
+	 * @return  boolean or false
 	 */
 	function _check_data ($file = null) {
 		if ( empty($this->file_data) ) {
@@ -706,6 +706,7 @@ 
 	/**
 	 * Check if passed info might be delimiter
 	 *  - only used by find_delimiter()
+	 * @param integer $depth
 	 * @return  special string used for delimiter selection, or false
 	 */
 	function _check_count ($char, $array, $depth, $preferred) {
@@ -737,7 +738,7 @@ 
 	/**
 	 * Read local file
 	 * @param   file   local filename
-	 * @return  Data from file, or false on failure
+	 * @return  false|string from file, or false on failure
 	 */
 	function _rfile ($file = null) {
 		if ( is_readable($file) ) {
@@ -755,7 +756,7 @@ 
 	 * @param   string   data to write to file
 	 * @param   mode     fopen() mode
 	 * @param   lock     flock() mode
-	 * @return  true or false
+	 * @return  boolean or false
 	 */
 	function _wfile ($file, $string = '', $mode = 'wb', $lock = 2) {
 		if ( $fp = fopen($file, $mode) ) {

include/pclzip/pclzip.lib.php

Doc Comments +18 added lines

@@ -2029,6 +2029,10 @@ 
   // Description :
   // Parameters :
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param string $p_mode
+   */
   function privOpenFd($p_mode)
   {
     //--(MAGIC-PclTrace)--//PclTraceFctStart(__FILE__, __LINE__, "PclZip::privOpenFd", 'mode='.$p_mode);
@@ -4711,6 +4715,10 @@ 
   // Parameters :
   // Return Values :
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param PclZip $p_archive_to_add
+   */
   function privMerge(&$p_archive_to_add)
   {
     //--(MAGIC-PclTrace)--//PclTraceFctStart(__FILE__, __LINE__, "PclZip::privMerge", "archive='".$p_archive_to_add->zipname."'");
@@ -5288,6 +5296,11 @@ 
   //             3 : src & dest gzip
   // Return Values :
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param integer $p_src
+   * @param integer $p_dest
+   */
   function PclZipUtilCopyBlock($p_src, $p_dest, $p_size, $p_mode=0)
   {
     //--(MAGIC-PclTrace)--//PclTraceFctStart(__FILE__, __LINE__, "PclZipUtilCopyBlock", "size=$p_size, mode=$p_mode");
@@ -5360,6 +5373,11 @@ 
   // Return Values :
   //   1 on success, 0 on failure.
   // --------------------------------------------------------------------------------
+
+  /**
+   * @param string $p_src
+   * @param string $p_dest
+   */
   function PclZipUtilRename($p_src, $p_dest)
   {
     //--(MAGIC-PclTrace)--//PclTraceFctStart(__FILE__, __LINE__, "PclZipUtilRename", "source=$p_src, destination=$p_dest");

include/Pear/XML_HTMLSax3/HTMLSax3.php

Doc Comments +13 added lines, -4 removed lines

@@ -190,7 +190,7 @@ 
     /**
     * Returns the next character from the XML document or void if at end
     * @access protected
-    * @return mixed
+    * @return string|null
     */
     function scanCharacter() {
         if ($this->position < $this->length) {
@@ -326,6 +326,7 @@ 
     * parser options
     * @var XML_HTMLSax3 instance of user front end class
     * @access protected
+    * @param XML_HTMLSax3 $htmlsax
     */
     function XML_HTMLSax3_StateParser_Lt430(& $htmlsax) {
         parent::XML_HTMLSax3_StateParser($htmlsax);
@@ -390,6 +391,7 @@ 
     * parser options
     * @var XML_HTMLSax3 instance of user front end class
     * @access protected
+    * @param XML_HTMLSax3 $htmlsax
     */
     function XML_HTMLSax3_StateParser_Gtet430(& $htmlsax) {
         parent::XML_HTMLSax3_StateParser($htmlsax);
@@ -499,9 +501,9 @@ 
     /**
     * Sets the user defined handler object. Returns a PEAR Error
     * if supplied argument is not an object.
-    * @param object handler object containing SAX callback methods
+    * @param object XML_HTMLSax3_NullHandler object containing SAX callback methods
     * @access public
-    * @return mixed
+    * @return boolean|null
     */
     function set_object(&$object) {
         if ( is_object($object) ) {
@@ -537,8 +539,9 @@ 
     * XML_OPTION_ENTITIES_PARSED and XML_OPTION_CASE_FOLDING
     * @param string name of parser option
     * @param int (optional) 1 to switch on, 0 for off
+    * @param string $name
     * @access public
-    * @return boolean
+    * @return boolean|null
     */
     function set_option($name, $value=1) {
         if ( array_key_exists($name,$this->state_parser->parser_options) ) {
@@ -559,6 +562,7 @@ 
     * function myDataHander(& $parser,$data){}
     * </pre>
     * @param string name of method
+    * @param string $data_method
     * @access public
     * @return void
     * @see set_object
@@ -582,6 +586,8 @@ 
     * </pre>
     * @param string name of open method
     * @param string name of close method
+    * @param string $opening_method
+    * @param string $closing_method
     * @access public
     * @return void
     * @see set_object
@@ -601,6 +607,7 @@ 
     * function myPIHander(& $parser,$target, $data){}
     * </pre>
     * @param string name of method
+    * @param string $pi_method
     * @access public
     * @return void
     * @see set_object
@@ -619,6 +626,7 @@ 
     * function myEscapeHander(& $parser, $data){}
     * </pre>
     * @param string name of method
+    * @param string $escape_method
     * @access public
     * @return void
     * @see set_object
@@ -636,6 +644,7 @@ 
     * function myJaspHander(& $parser, $data){}
     * </pre>
     * @param string name of method
+    * @param string $jasp_method
     * @access public
     * @return void
     * @see set_object

include/Pear/XML_HTMLSax3/HTMLSax3/Decorators.php

Doc Comments +12 added lines

@@ -49,6 +49,7 @@ 
     * Constructs XML_HTMLSax3_Trim
     * @param object handler object being decorated
     * @param string original handler method
+    * @param string $orig_method
     * @access protected
     */
     function XML_HTMLSax3_Trim(&$orig_obj, $orig_method) {
@@ -97,6 +98,8 @@ 
     * @param object handler object being decorated
     * @param string original open handler method
     * @param string original close handler method
+    * @param string $orig_open_method
+    * @param string $orig_close_method
     * @access protected
     */
     function XML_HTMLSax3_CaseFolding(&$orig_obj, $orig_open_method, $orig_close_method) {
@@ -147,6 +150,7 @@ 
     * Constructs XML_HTMLSax3_LineFeed
     * @param object handler object being decorated
     * @param string original handler method
+    * @param string $orig_method
     * @access protected
     */
     function XML_HTMLSax3_LineFeed(&$orig_obj, $orig_method) {
@@ -189,6 +193,7 @@ 
     * Constructs XML_HTMLSax3_Tab
     * @param object handler object being decorated
     * @param string original handler method
+    * @param string $orig_method
     * @access protected
     */
     function XML_HTMLSax3_Tab(&$orig_obj, $orig_method) {
@@ -232,6 +237,7 @@ 
     * Constructs XML_HTMLSax3_Entities_Parsed
     * @param object handler object being decorated
     * @param string original handler method
+    * @param string $orig_method
     * @access protected
     */
     function XML_HTMLSax3_Entities_Parsed(&$orig_obj, $orig_method) {
@@ -256,6 +262,10 @@ 
 * Compatibility with older PHP versions
 */
 if (version_compare(phpversion(), '4.3', '<') && !function_exists('html_entity_decode') ) {
+
+    /**
+     * @param integer $style
+     */
     function html_entity_decode($str, $style=ENT_NOQUOTES) {
         return strtr($str,
             array_flip(get_html_translation_table(HTML_ENTITIES,$style)));
@@ -284,6 +294,7 @@ 
     * Constructs XML_HTMLSax3_Entities_Unparsed
     * @param object handler object being decorated
     * @param string original handler method
+    * @param string $orig_method
     * @access protected
     */
     function XML_HTMLSax3_Entities_Unparsed(&$orig_obj, $orig_method) {
@@ -327,6 +338,7 @@ 
     * Constructs XML_HTMLSax3_Entities_Unparsed
     * @param object handler object being decorated
     * @param string original handler method
+    * @param string $orig_method
     * @access protected
     */
     function XML_HTMLSax3_Escape_Stripper(&$orig_obj, $orig_method) {

include/Pear/XML_HTMLSax3/HTMLSax3/States.php

Doc Comments +7 added lines, -7 removed lines

@@ -45,7 +45,7 @@ 
 class XML_HTMLSax3_StartingState  {
     /**
     * @param XML_HTMLSax3_StateParser subclass
-    * @return constant XML_HTMLSAX3_STATE_TAG
+    * @return integer XML_HTMLSAX3_STATE_TAG
     * @access protected
     */
     function parse(&$context) {
@@ -66,7 +66,7 @@ 
 class XML_HTMLSax3_TagState {
     /**
     * @param XML_HTMLSax3_StateParser subclass
-    * @return constant the next state to move into
+    * @return integer|null the next state to move into
     * @access protected
     */
     function parse(&$context) {
@@ -97,7 +97,7 @@ 
 class XML_HTMLSax3_ClosingTagState {
     /**
     * @param XML_HTMLSax3_StateParser subclass
-    * @return constant XML_HTMLSAX3_STATE_START
+    * @return integer XML_HTMLSAX3_STATE_START
     * @access protected
     */
     function parse(&$context) {
@@ -167,7 +167,7 @@ 
 
     /**
     * @param XML_HTMLSax3_StateParser subclass
-    * @return constant XML_HTMLSAX3_STATE_START
+    * @return integer XML_HTMLSAX3_STATE_START
     * @access protected
     */
     function parse(&$context) {
@@ -205,7 +205,7 @@ 
 class XML_HTMLSax3_EscapeState {
     /**
     * @param XML_HTMLSax3_StateParser subclass
-    * @return constant XML_HTMLSAX3_STATE_START
+    * @return integer XML_HTMLSAX3_STATE_START
     * @access protected
     */
     function parse(&$context) {
@@ -247,7 +247,7 @@ 
 class XML_HTMLSax3_JaspState {
     /**
     * @param XML_HTMLSax3_StateParser subclass
-    * @return constant XML_HTMLSAX3_STATE_START
+    * @return integer XML_HTMLSAX3_STATE_START
     * @access protected
     */
     function parse(&$context) {
@@ -269,7 +269,7 @@ 
 class XML_HTMLSax3_PiState {
     /**
     * @param XML_HTMLSax3_StateParser subclass
-    * @return constant XML_HTMLSAX3_STATE_START
+    * @return integer XML_HTMLSAX3_STATE_START
     * @access protected
     */
     function parse(&$context) {

include/phpmailer/class.smtp.php

Doc Comments +1 added lines, -1 removed lines

@@ -954,7 +954,7 @@
      * Send raw data to the server.
      * @param string $data The data to send
      * @access public
-     * @return integer|boolean The number of bytes sent to the server or false on error
+     * @return integer The number of bytes sent to the server or false on error
      */
     public function client_send($data)
     {