comparison src/alloc.c @ 3355:721daee0fcd8

[xemacs-hg @ 2006-04-23 20:12:25 by aidan] Take on board feedback from Stephen on my last changes.
author aidan
date Sun, 23 Apr 2006 20:12:31 +0000
parents 1043bbfa24cf
children fd2936bbfc5f
comparison
equal deleted inserted replaced
3354:15fb91e3a115 3355:721daee0fcd8
1253 0, 1253 0,
1254 cons_description, 1254 cons_description,
1255 Lisp_Cons); 1255 Lisp_Cons);
1256 1256
1257 DEFUN ("cons", Fcons, 2, 2, 0, /* 1257 DEFUN ("cons", Fcons, 2, 2, 0, /*
1258 Create a new cons, give it CAR and CDR as components, and return it. 1258 Create a new cons cell, give it CAR and CDR as components, and return it.
1259
1260 A cons cell is a Lisp object (an area in memory) made up of two pointers
1261 called the CAR and the CDR. Each of these pointers can point to any other
1262 Lisp object. The common Lisp data type, the list, is a specially-structured
1263 series of cons cells.
1264
1265 The pointers are accessed from Lisp with `car' and `cdr', and mutated with
1266 `setcar' and `setcdr' respectively. For historical reasons, the aliases
1267 `rplaca' and `rplacd' (for `setcar' and `setcdr') are supported.
1259 */ 1268 */
1260 (car, cdr)) 1269 (car, cdr))
1261 { 1270 {
1262 /* This cannot GC. */ 1271 /* This cannot GC. */
1263 Lisp_Object val; 1272 Lisp_Object val;