Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
Overview
| Comment: | Fix nroff syntax botch in documentation. |
|---|---|
| Downloads: | Tarball | ZIP archive | SQL archive |
| Timelines: | family | ancestors | descendants | both | trunk |
| Files: | files | file ages | folders |
| SHA3-256: |
b5c0638471efd9e12a7b7bc4cbbd92c9 |
| User & Date: | dgp 2019-11-03 02:28:05 |
Context
|
2019-11-03
| ||
| 02:30 | TEA updates check-in: e17d63569a user: dgp tags: trunk | |
| 02:28 | Fix nroff syntax botch in documentation. check-in: b5c0638471 user: dgp tags: trunk | |
|
2019-10-30
| ||
| 19:26 | Greatly streamline Itcl_EvalArgs(). Still should trash it. check-in: b7d4853b31 user: dgp tags: trunk | |
Changes
Changes to doc/Preserve.3.
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 |
deallocation. .PP \fBItcl_EventuallyFree\fR is called on a pointer \fIptr\fR allocated by \fBItcl_Alloc\fR to register a deallocation routine \fIfproc\fR to be called when the number of calls to \fBItcl_ReleaseData\fR on \fIptr\fR matches the number of calls to \fBItcl_PreserveData\fR on \fIptr\fR. This condition indicates all modules have ended their interest in the block of memory and a call to \fIfproc\ with argument \fIptr\fR will deallocate the memory that no module needs anymore. .PP \fBItcl_Free\fR is a deallocation routine for a \fIptr\fR value allocated by \fBItcl_Alloc\fR. It may be called on any \fIptr\fR with no history of an \fBItcl_PreserveData\fR call unmatched by an \fBItcl_ReleaseData\fR call. It is best used as an \fIfproc\fR argument to \fBItcl_EventuallyFree\fR or as a routine called from within such an \fIfproc\fR routine. It can also be used to deallocate a \fIptr\fR value when it can be assured that value has never been passed to \fBItcl_PreserveData\fR or \fBItcl_EventuallyFree\fR. .SH KEYWORDS free, memory |
| |
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 |
deallocation.
.PP
\fBItcl_EventuallyFree\fR is called on a pointer \fIptr\fR allocated by
\fBItcl_Alloc\fR to register a deallocation routine \fIfproc\fR to be
called when the number of calls to \fBItcl_ReleaseData\fR on \fIptr\fR
matches the number of calls to \fBItcl_PreserveData\fR on \fIptr\fR. This
condition indicates all modules have ended their interest in the block
of memory and a call to \fIfproc\fR with argument \fIptr\fR will deallocate
the memory that no module needs anymore.
.PP
\fBItcl_Free\fR is a deallocation routine for a \fIptr\fR value allocated
by \fBItcl_Alloc\fR. It may be called on any \fIptr\fR with no history of
an \fBItcl_PreserveData\fR call unmatched by an \fBItcl_ReleaseData\fR
call. It is best used as an \fIfproc\fR argument to \fBItcl_EventuallyFree\fR
or as a routine called from within such an \fIfproc\fR routine. It can also
be used to deallocate a \fIptr\fR value when it can be assured that value
has never been passed to \fBItcl_PreserveData\fR or \fBItcl_EventuallyFree\fR.
.SH KEYWORDS
free, memory
|