Changeset 11247 for lib

Timestamp:

07/06/06 21:39:38 (3 years ago)

Author:

gaal

Message:

* Style.pod - minor tweaks

Files:

• lib/Pugs/Doc/Hack/Style.pod (modified) (3 diffs)

lib/Pugs/Doc/Hack/Style.pod

@@ -20 +20 @@
   data Val = Int Int | String String | ...
 
-Then readers of code that uses these types may get confused about when
-you are using Val, Int, and String as concrete types and when you are
-constructing a value.
+Then readers your code may get confused about when you are using Val,
+Int, and String as concrete types and when you are constructing a value.
 
 The following convention is proposed. It can help against this problem,
@@ -56 +55 @@
 in constructor and in field names:
 
+   -- Aliases always refer to toplevel name, so not "StorageVal" here
    type EntryStorage = TVar Val
 
@@ -63 +63 @@
       }
 
-Multiple variant records can drop the C<Mk> prefix and start with the
+Multiple variant records drop the C<Mk> prefix and start with the
 given name:
 
-   type ObjClass   = Class
    type MutClass   = Class
+   type ObjClass   = Class           -- Again, refer to toplevel directly
+
    type ObjId      = Native
    type ObjSlots   = TVar (Map Ident Val)