Index: ./services/system_service/system_service.inc
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/services/services/system_service/Attic/system_service.inc,v
retrieving revision 1.1.2.5.2.3
diff -u -p -r1.1.2.5.2.3 system_service.inc
--- ./services/system_service/system_service.inc	26 Jan 2010 22:07:31 -0000	1.1.2.5.2.3
+++ ./services/system_service/system_service.inc	21 Feb 2010 19:32:51 -0000
@@ -1,12 +1,16 @@
-<?php
+ <?php
 // $Id: system_service.inc,v 1.1.2.5.2.3 2010/01/26 22:07:31 heyrocker Exp $
+
 /**
  * @file
  *  Link general system functionalities to services module.
  */
 
 /**
- * Returns a specified node.
+ * Create a new anonymous session for services.
+ *
+ * @return 
+ *   A new session object.
  */
 function system_service_connect() {
   global $user;
@@ -18,6 +22,9 @@ function system_service_connect() {
   return $return;
 }
 
+/**
+ * Implementation of hook_mail().
+ */
 function system_service_mail($mailkey, &$message, $params) {
   $language = $message['language'];
   $variables = user_mail_tokens($params['account'], $language);
@@ -30,6 +37,26 @@ function system_service_mail($mailkey, &
 
 /**
  * Send an email using the Services module.
+ *
+ * @param $mailkey
+ *   A key to identify the e-mail sent.
+ * @param $to
+ *   The recipient's email address(es).  The formatting of this string must 
+ *   comply with RFC 2822.
+ * @param $subject
+ *   The subject of the email.
+ * @param $body
+ *   The body of the email. 
+ * @param $from
+ *   The sender's email address.
+ * @param $headers
+ *   An associative array of optional mail headers.
+ *
+ * @return
+ *   An array structure containing all details of the message.
+ *
+ * @see hook_mail()
+ * @see drupal_mail()
  */
 function system_service_mailprepare($mailkey, $to, $subject, $body, $from = NULL, $headers = array()) {
   $params = array();
@@ -45,14 +72,31 @@ function system_service_mailprepare($mai
 }
 
 /**
- * Returns a specified variable.
+ * Services implementation of variable_get().
+ *
+ * @param $name
+ *   The name of the variable to return.
+ * @param $default
+ *   The value to use if the variable has never been set.
+ *
+ * @return
+ *   The value of the variable.
+ *
+ * @see variable_get()
  */
 function system_service_getvariable($name, $default = NULL) {
   return variable_get($name, $default);
 }
 
 /**
- * Set a variable.
+ * Services implementation of variable_set().
+ *
+ * @param $name
+ *   The name of the variable to set.
+ * @param $value
+ *   The value to set this variable to.
+ *
+ * @see variable_set()
  */
 function system_service_setvariable($name, $value) {
   variable_set($name, $value);
@@ -60,6 +104,13 @@ function system_service_setvariable($nam
 
 /**
  * Check if a module is enabled. If so, return its version.
+ *
+ * @param $module
+ *   The name of the module to check.
+ *
+ * @return
+ *   The module's version string, or nothing if the module
+ *   is not enable or installed.
  */
 function system_service_module_exists($module) {
   if (module_exists($module)) {
@@ -73,14 +124,21 @@ function system_service_module_exists($m
 }
 
 /**
- * Returns all the available services
+ * Return and array of all the available services.
+ *
+ * @return array
+ *   An array containing all services and thir methods
+ *
+ * @see services_get_all()
  */
 function system_service_getservices() {
   return services_get_all();
 }
 
 /**
- * Clear all caches
+ * Services implementation of cache_clear_all().
+ *
+ * @see cache_clear_all()
  */
 function system_service_cache_clear_all() {
   drupal_flush_all_caches();
@@ -90,6 +148,17 @@ function system_service_cache_clear_all(
 /**
  * Log a system message.
  *
+ * @param $type
+ *   The category to which this message belongs.
+ * @param $message
+ *   The message to store in the log.
+ * @param $variables
+ *   Array of variables to replace in the message on display.
+ * @param $severity
+ *   The severity of the message, as per RFC 3164.
+ * @param $link
+ *   A link to associate with the message.
+ *
  * @see watchdog()
  **/
 function system_service_watchdog_send($type, $message, $variables = array(), $severity = WATCHDOG_NOTICE, $link = NULL) {