tenuring

Arguments: &body body

Use this macro to immediately tenure all objects allocated while within the scope of body. This macro is normally used when loading files, or performing some other operation where the objects created will not become garbage in the short term. (Objects with pointer-storage-type :pan are never tenured and are thus unaffected.)

In releases prior to 6.0, body was wrapped in a prog1 and so only the first value returned by body was returned. Starting in 6.0, body is wrapped in a multiple-value-prog1 so all values are returned.

This macro is very useful for preventing newspace expansion. Without the tenuring macro, loading a very large fasl file may cause the newspace to expand to several times its previous size. With the tenuring macro, the newspace will not grow as severely, which will usually improve performance in the resulting Lisp.

See also gc.htm for general information on garbage collection in Allegro CL.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.