Comments

Always you should write comments. Each comment should has the following entries.

# Descriptions: 
#    Arguments: $self $args
# Side Effects: 
# Return Value: none

// Descriptions: 
//    Arguments: $self $args
// Side Effects: 
// Return Value: none

/*
 * Descriptions: 
 *    Arguments: $self $args 
 * Side Effects: 
 * Return Value: none
 */

If you use perl, please write POD in addition to the comment described above.

OBJ($curproc)
STR($buf)

TERM   What ?              perl internal
----------------------------------------------------------
OBJ    object              (blessed variable)
STR    string              (PV (SV special case))
NUM    number              (SV)
ARRAY  array               (AV)
HASH   hash                (HV)
HANDLE file handle         (GV)

ARRAY_REF
HASH_REF