Changeset 35626 in project

Timestamp:

06/20/18 21:17:34 (9 months ago)

Author:

sjamaan

Message:

Add defstruct to eggref/5

File:

• wiki/eggref/5/defstruct (copied) (copied from wiki/eggref/4/defstruct) (5 diffs)

wiki/eggref/5/defstruct

@@ -29 +29 @@
 
 <enscript highlight="scheme">
-(require-extension defstruct)
+(import defstruct)
 
 (defstruct point x y)
@@ -50 +50 @@
 </enscript>
 
-On Chicken 4 and higher, there are also two procedures {{update-STRUCTNAME}}
-and {{set-STRUCTNAME!}} defined for functionally and destructively updating
-selected values in an existing record:
+There are also two procedures {{update-STRUCTNAME}} and
+{{set-STRUCTNAME!}} defined for functionally and destructively
+updating selected values in an existing record:
 
 <enscript highlight="scheme">
@@ -67 +67 @@
 </enscript>
 
-Additionally, there are two conversion procedures for converting to
-and from alists, {{STRUCTNAME->alist}} and {{alist->STRUCTNAME}}:
+Finally, there are two conversion procedures for converting to and
+from alists, {{STRUCTNAME->alist}} and {{alist->STRUCTNAME}}:
 
 <enscript highlight="scheme">
@@ -82 +82 @@
 === Bugs and limitations
 
+This macro is unhygienic which, while resulting in concise syntax, has
+some drawbacks:
+
 * Just like with {{define-record}} you cannot use field names ending with {{-set!}} if you also have a similar field name not ending with {{-set!}}.
-* Just like with {{define-record}} you should avoid defining record types with a name that is a prefix of another record type's name.
+* Just like with {{define-record}} you should avoid defining record types with a name that is a prefix of another record type's name in the same module, because that might cause naming clashes.
+* For the same reason, you should avoid defining record types named {{make}} or {{update}}.
 * You cannot use a field named {{>alist}}.
-* You should avoid defining record types named {{make}} or {{update}}.
 
 === License
@@ -91 +94 @@
   Copyright (c) 2005, Dorai Sitaram
   Copyright (c) 2005, Felix Winkelmann (Chicken port)
-  Copyright (c) 2008-2010, Peter Bex (Hygienic Chicken port + extensions)
+  Copyright (c) 2008-2018, Peter Bex (Hygienic Chicken port + extensions)
   All rights reserved.