.\" Process this file with
.\" groff -man -Tascii cryptday.1
.\"
.TH js_dealloc 3 "August 2000" JS "js library reference"
.\" We don't want hyphenation (it's too ugly)
.\" We also disable justification when using nroff
.hy 0
.if n .na
.SH NAME
js_dealloc \- allocate memory from the underlying OS
.SH SYNOPSIS
.nf
.B #include "JsStr.h"
.sp
.B "int js_dealloc(void *pointer)"
.fi
.SH DESCRIPTION
.B js_dealloc
returns previously allocated memory back to the underlying OS.  
.SH ARGUMENTS
.B pointer
is a pointer to the memory we wish to free up.
.SH "RETURN VALUE"
.B js_dealloc
returns JS_SUCCESS after deallocating the memory in question.
.SH EXAMPLE
The following example allocates then deallocates 256 octets of memory.

.nf
	char *foo;
	foo = js_alloc(256,1);
	js_dealloc(foo);
.fi
.SH NOTES
This function assumes that an allocated chunk of memory will not move in 
memory.  On certain embedded systems, such as the Palm Pilot, allocated memory
may move around in memory.
.SH AUTHOR
Sam Trenholme <kiwi-zttfryb@koala.samiam.org>