From: edwin <none@none>
Date: Fri, 26 May 2006 12:19:43 +0000 (+0000)
Subject: * src/vm/builtin.c (builtin_init): Documented.
X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=commitdiff_plain;h=a5cf5a2d89e1ef38cd3b0a19ce0a144f4e355011;p=cacao.git

* src/vm/builtin.c (builtin_init): Documented.
(builtin_trace_args): Documented.
(builtin_displaymethodstop): Documented.

* src/vm/jit/alpha/md-abi.c (md_param_alloc): Documented.

* src/vm/jit/allocator/simplereg.c (allocate_scratch_registers):
Documented.

* src/vm/jit/codegen-common.c (methodtree_comparator): Documented.
(codegen_insertmethod): Documented.

* src/toolbox/util.c (getcwd): Documented.
---

diff --git a/src/toolbox/util.c b/src/toolbox/util.c
index 610e6aa95..b21495559 100644
--- a/src/toolbox/util.c
+++ b/src/toolbox/util.c
@@ -28,7 +28,7 @@
 
    Changes:
 
-   $Id: util.c 4357 2006-01-22 23:33:38Z twisti $
+   $Id: util.c 4960 2006-05-26 12:19:43Z edwin $
 
 */
 
@@ -47,7 +47,11 @@
 
 /* getcwd **********************************************************************
 
-   XXX
+   Return the current working directory.
+
+   RETURN VALUE:
+       pointer to a char array allocated by MNEW, or
+	   NULL if memory could not be allocated.
 
 *******************************************************************************/
 
diff --git a/src/vm/builtin.c b/src/vm/builtin.c
index ae613c834..66d674520 100644
--- a/src/vm/builtin.c
+++ b/src/vm/builtin.c
@@ -37,7 +37,7 @@
    calls instead of machine instructions, using the C calling
    convention.
 
-   $Id: builtin.c 4921 2006-05-15 14:24:36Z twisti $
+   $Id: builtin.c 4960 2006-05-26 12:19:43Z edwin $
 
 */
 
@@ -245,7 +245,7 @@ static void builtintable_sort_automatic(void)
 
 /* builtin_init ****************************************************************
 
-   XXX
+   Initialize the global table of builtin functions.
 
 *******************************************************************************/
 
@@ -1271,7 +1271,7 @@ java_objectheader *builtin_trace_exception(java_objectheader *xptr,
 
 /* builtin_trace_args **********************************************************
 
-   XXX
+   Print method call with arguments for -verbose:call.
 
 *******************************************************************************/
 
@@ -1537,7 +1537,7 @@ void builtin_trace_args(s8 a0, s8 a1,
 
 /* builtin_displaymethodstop ***************************************************
 
-   XXX
+   Print method exit for -verbose:call.
 
 *******************************************************************************/
 
diff --git a/src/vm/jit/allocator/simplereg.c b/src/vm/jit/allocator/simplereg.c
index a814a092a..2ec392e9f 100644
--- a/src/vm/jit/allocator/simplereg.c
+++ b/src/vm/jit/allocator/simplereg.c
@@ -32,7 +32,7 @@
             Michael Starzinger
             Edwin Steiner
 
-   $Id: simplereg.c 4921 2006-05-15 14:24:36Z twisti $
+   $Id: simplereg.c 4960 2006-05-26 12:19:43Z edwin $
 
 */
 
@@ -1164,7 +1164,7 @@ static void reg_mark_copy(registerdata *rd, stackptr src_top, stackptr src_botto
 
 /* allocate_scratch_registers **************************************************
 
-   XXX
+   Allocate temporary (non-interface, non-local) registers.
 
 *******************************************************************************/
 
diff --git a/src/vm/jit/alpha/md-abi.c b/src/vm/jit/alpha/md-abi.c
index afa7f49cc..ac5e6875c 100644
--- a/src/vm/jit/alpha/md-abi.c
+++ b/src/vm/jit/alpha/md-abi.c
@@ -28,7 +28,7 @@
 
    Changes: Christian Ullrich
 
-   $Id: md-abi.c 4357 2006-01-22 23:33:38Z twisti $
+   $Id: md-abi.c 4960 2006-05-26 12:19:43Z edwin $
 
 */
 
@@ -63,7 +63,8 @@ s4 nregdescfloat[] = {
 
 /* md_param_alloc **************************************************************
 
-   XXX
+   Allocate the parameters of the given method descriptor according to the
+   calling convention of the platform.
 
 *******************************************************************************/
 
diff --git a/src/vm/jit/codegen-common.c b/src/vm/jit/codegen-common.c
index 95c0399a5..294dc0923 100644
--- a/src/vm/jit/codegen-common.c
+++ b/src/vm/jit/codegen-common.c
@@ -48,7 +48,7 @@
    memory. All functions writing values into the data area return the offset
    relative the begin of the code area (start of procedure).	
 
-   $Id: codegen-common.c 4921 2006-05-15 14:24:36Z twisti $
+   $Id: codegen-common.c 4960 2006-05-26 12:19:43Z edwin $
 
 */
 
@@ -469,7 +469,7 @@ void codegen_addpatchref(codegendata *cd, functionptr patcher, voidptr ref,
 #if defined(__I386__) || defined(__X86_64__) || defined(ENABLE_INTRP) || defined(DISABLE_GC)
 /* methodtree_comparator *******************************************************
 
-   XXX
+   Comparator function used for the AVL tree of methods.
 
 *******************************************************************************/
 
@@ -502,7 +502,7 @@ static s4 methodtree_comparator(const void *pc, const void *element)
 
 /* codegen_insertmethod ********************************************************
 
-   XXX
+   Insert the machine code range of a method into the AVL tree of methods.
 
 *******************************************************************************/
 
@@ -526,7 +526,7 @@ void codegen_insertmethod(u1 *startpc, u1 *endpc)
 
 /* codegen_findmethod **********************************************************
 
-   XXX
+   Find the PV for the given PC by searching in the AVL tree of methods.
 
 *******************************************************************************/