syncml-ctoolkit-cvs

[Kidong L. <bri...@us...>]

Update of /cvsroot/syncml-ctoolkit/toolkit/src/sml/lib/all
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv10631/src/sml/lib/all

Modified Files:
	liblock.c libmem.c libstr.c libutil.c 
Log Message:
Modified comments to doxygen-readable
Removed duplicated comments



Index: liblock.c
===================================================================
RCS file: /cvsroot/syncml-ctoolkit/toolkit/src/sml/lib/all/liblock.c,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** liblock.c	2 May 2003 22:05:07 -0000	1.1
--- liblock.c	24 May 2004 01:33:35 -0000	1.2
***************
*** 1,3 ****
! /* thread-locking library, RTK addition by lu...@sy... */
  
  #include "syncml_tk_prefix_file.h" // %%% luz: needed for precompiled headers in eVC++
--- 1,10 ----
! /**
!  * @file 
!  * Library for Thread Locking Functions
!  *
!  * @target_system   ALL
!  * @target_os       ALL
!  * @description thread-locking library, RTK addition by lu...@sy...
!  */
  
  #include "syncml_tk_prefix_file.h" // %%% luz: needed for precompiled headers in eVC++
***************
*** 66,68 ****
  #endif
  
! /* eof */
\ No newline at end of file
--- 73,75 ----
  #endif
  
! /* eof */

Index: libstr.c
===================================================================
RCS file: /cvsroot/syncml-ctoolkit/toolkit/src/sml/lib/all/libstr.c,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** libstr.c	2 May 2003 22:05:07 -0000	1.2
--- libstr.c	24 May 2004 01:33:35 -0000	1.3
***************
*** 1,12 ****
! /*************************************************************************/
! /* module:          Library for String Functions                         */
! /*                                                                       */
! /* file:            libstr.c                                             */
! /* target system:   ALL                                                  */
! /* target OS:       ALL                                                  */   
! /*                                                                       */
! /* Description:                                                          */
! /* implementation of common string-handling functions                    */
! /*************************************************************************/
  
  /*
--- 1,10 ----
! /**
!  * @file 
!  * Library for String Functions
!  *
!  * @target_system   ALL
!  * @target_os       ALL
!  * @description implementation of common string-handling functions
!  */
  
  /*
***************
*** 71,82 ****
  
  /**
-  * FUNCTION: smlLibStrdup
-  *
   * Duplicates the String "constStringP".
   * Returns a pointer to the new copy of "constStringP". 
   *
!  * IN:              String_t   constStringP     string, which is duplicated
!  * RETURN:          String_t   pointer to the new copy,
!  *                             null, if no copy could be allocated
   */
  SML_API String_t smlLibStrdup (const char *constStringP)
--- 69,79 ----
  
  /**
   * Duplicates the String "constStringP".
   * Returns a pointer to the new copy of "constStringP". 
   *
!  * @param constStringP (IN)
!  *        string which is duplicated
!  * @return pointer to the new copy,\n
!  *         NULL if no copy could be allocated
   */
  SML_API String_t smlLibStrdup (const char *constStringP)

Index: libutil.c
===================================================================
RCS file: /cvsroot/syncml-ctoolkit/toolkit/src/sml/lib/all/libutil.c,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** libutil.c	2 May 2003 22:05:07 -0000	1.2
--- libutil.c	24 May 2004 01:33:35 -0000	1.3
***************
*** 1,12 ****
! /*************************************************************************/
! /* module:          Library for IO        Functions                      */
! /*                                                                       */
! /* file:            libio.c                                              */
! /* target system:   ALL                                                  */
! /* target OS:       ALL                                                  */
! /*                                                                       */
! /* Description:                                                          */
! /* Utility I/O  functions                                                */
! /*************************************************************************/
  
  
--- 1,10 ----
! /**
!  * @file 
!  * Library for IO Functions
!  *
!  * @target_system   ALL
!  * @target_os       ALL
!  * @description Utility I/O  functions
!  */
  
  
***************
*** 99,118 ****
  
  /**
-  * FUNCTION: smlLibPrint
-  *
   * Assembles a formatted textstring out of a list of argument. This string is
   * passed to a callback function, which is implementated by the application
   * for output to the user
   *
!  * IN:              A printf like format text string with multiple
!  *                  arguments to be formatted as specified
!  *                  Supported are:
!  *                  %d, %i, %u, %x, %s, %c
!  *                  +, -, <space>, *, <number>, h, l, L
!  *
!  * RETURN:          - - -
   */
- 
- 
  SML_API void smlLibPrint(const char *text, ...)
  {
--- 97,111 ----
  
  /**
   * Assembles a formatted textstring out of a list of argument. This string is
   * passed to a callback function, which is implementated by the application
   * for output to the user
   *
!  * @param text (IN)
!  *        printf like format text string with multiple
!  *        arguments to be formatted as specified\n
!  *        Supported are:
!  *        \%d, \%i, \%u, \%x, \%s, \%c\n
!  *        +, -, \<space\>, *, \<number\>, h, l, L
   */
  SML_API void smlLibPrint(const char *text, ...)
  {

Index: libmem.c
===================================================================
RCS file: /cvsroot/syncml-ctoolkit/toolkit/src/sml/lib/all/libmem.c,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** libmem.c	15 Sep 2003 12:52:24 -0000	1.3
--- libmem.c	24 May 2004 01:33:35 -0000	1.4
***************
*** 1,12 ****
! /*************************************************************************/
! /* module:          Library for Memory Functions                         */
! /*                                                                       */
! /* file:            libmem.c                                             */
! /* target system:   ALL                                                  */
! /* target OS:       ALL                                                  */   
! /*                                                                       */
! /* Description:                                                          */
! /* Header for the implementation of common memory handling functions     */
! /*************************************************************************/
  
  /*
--- 1,11 ----
! /**
!  * @file 
!  * Library for Memory Functions
!  *
!  * @target_system   ALL
!  * @target_os       ALL
!  * @description Header for the implementation of common memory handling
!  * functions
!  */
  
  /*
***************
*** 69,74 ****
  
  /**
-  * FUNCTION: smlLibFree
-  *
   * Deallocates the memory of object "pObject", which has been allocated
   * previously.
--- 68,71 ----
***************
*** 95,100 ****
  
  /**
-  * FUNCTION: smlLibRealloc
-  *
   * Changes size of preallocated space for memory object "pObject"
   * to the new size specified by "constSize".
--- 92,95 ----
***************
*** 118,127 ****
   * without changing the memory object "pObject" (Nothing happens to the content).
   *
!  * IN/OUT           void *pObject,      memory object, which size should be changed
!  * IN:              MemSize_t constSize new size the memory object shall use
!  * RETURN:          void*               Pointer to memory object, which size has been
!  *                                      be changed
!  *                                      NULL, if not successfull or
!  *                                            if constSize==0
   */
  SML_API void *smlLibRealloc(void *pObject, MemSize_t constSize)
--- 113,122 ----
   * without changing the memory object "pObject" (Nothing happens to the content).
   *
!  * @param pObject (IN/OUT)
!  *        memory object, which size should be changed
!  * @param constSize (IN)
!  *        new size the memory object shall use
!  * @return void pointer to memory object, which size has been be changed\n
!  *         NULL, if not successfull or if constSize==0
   */
  SML_API void *smlLibRealloc(void *pObject, MemSize_t constSize)