Changeset 999

Timestamp:

04/01/09 01:33:16 (3 years ago)

Author:

walter

Message:

update docs

Files:

• trunk/docsrc/changelog.dd (modified) (6 diffs)
• trunk/docsrc/class.dd (modified) (2 diffs)
• trunk/docsrc/struct.dd (modified) (1 diff)

trunk/docsrc/changelog.dd

@@ -42 +42 @@
-)
-
-29
+31
-
-    $(WHATSNEW
-    $(LI Most functions in std.math are now pure nothrow. Improved speed of std.math.hypot.)
-    $(LI Added response files for Linux and OSX)
-B alias this
+LINK2 class.html#AliasThis, $(B alias this)
-    $(LI $(BUGZILLA 2746): Make float.init signalling NaN by default)
-    $(LI On Windows, if there are multiple source files on the command
@@ -53 +53 @@
-     compilation.)
-    $(LI Folded in patches for LDC compatibility from Tomas Lindquist Olsen)
+    $(LI Removed $(B etc.gamma) from the library.)
-    )
-    $(BUGSFIXED
@@ -59 +60 @@
-    $(LI $(BUGZILLA 920): Fix one more out of date reference to 'auto' rather than 'scope')
-    $(LI $(BUGZILLA 1645): can override base class' const method with non-const method)
+    $(LI $(BUGZILLA 2319): "Win32 Exception" not very useful)
+    $(LI $(BUGZILLA 2336): link to nonexistent std_array.html)
-    $(LI $(BUGZILLA 2570): Patch for some mistakes in Ddoc comments)
+    $(LI $(BUGZILLA 2574): std.c.stdio doesn't compile: va_list not defined!)
+    $(LI $(BUGZILLA 2591): custom allocator new argument should be size_t instead of uint)
-    $(LI $(BUGZILLA 2595): template ctors crash compiler)
-    $(LI $(BUGZILLA 2596): Variadic constructors don't compile)
-    $(LI $(BUGZILLA 2626): template function not working against template struct instantiated with default arguments)
-    $(LI $(BUGZILLA 2674): Copy postblit constructor this(this) not called for members)
+    $(LI $(BUGZILLA 2689): seek behaves incorrectly on MAC OSX)
-    $(LI $(BUGZILLA 2692): alignment of double on x86 linux is incorrect)
-    $(LI $(BUGZILLA 2700): typeof tests stops compilation abruptly)
@@ -78 +84 @@
-    $(LI $(BUGZILLA 2731): Errors in associative array example)
-    $(LI $(BUGZILLA 2739): _argptr is invalid for functions nested in class methods)
+    $(LI $(BUGZILLA 2743): dumpobj gives "buss error" on Tiger)
-    $(LI $(BUGZILLA 2744): wrong init tocbuffer of forstatement)
-    $(LI $(BUGZILLA 2745): missing token tochars in lexer.c)
@@ -83 +90 @@
-    $(LI $(BUGZILLA 2750): Optimize slice copy with size known at compile time)
-    $(LI $(BUGZILLA 2751): incorrect scope storage class vardeclaration tocbuffer)
+    $(LI $(BUGZILLA 2752): std.xml does not encode CData correctly)
-    $(LI $(BUGZILLA 2754): The error message regarding implicit conversion to shared doesn't mention shared in the message.)
-    $(LI $(BUGZILLA 2755): ICE on invalid ref returns in linked objects: Assertion failure: 'type' on line 6566 in file 'expression.c'. No ICE or error if invalid code is local to the file.)
@@ -90 +98 @@
-    $(LI $(BUGZILLA 2766): DMD hangs with 0%cpu)
-    $(LI $(BUGZILLA 2767): DMD incorrectly mangles NTFS stream names)
+    $(LI $(BUGZILLA 2772): lib can't open response file)
-    )
-)

trunk/docsrc/class.dd

@@ -92 +92 @@
-        $(LI $(LINK2 #allocators, Class Allocators))
-        $(LI $(LINK2 #deallocators, Class Deallocators))
+$(V2
+        $(LI $(LINK2 #AliasThis, Alias This)))
-    )
-    )
@@ -848 +850 @@
-    )
-
+$(V2
+<h3>$(LNAME2 AliasThis, Alias This)</h3>
+
+$(GRAMMAR
+$(GNAME AliasThis):
+    $(B alias) $(I Identifier) $(B this;)
+)
+
+    $(P An $(I AliasThis) declaration names another class or struct member
+    to which any undefined lookups will be forwarded.
+    The $(I Identifier) names that member.
+    )
+
+    $(P A class or struct can be implicitly converted to the $(I AliasThis)
+    member.
+    )
+
+    $(P There is only one $(I AliasThis) allowed per class or struct.
+    )
+
+---
+struct S
+{   int x;
+    alias x this;
+}
+
+int foo(int i) { return i * 2; }
+
+void test()
+{
+    S s;
+    s.x = 7;
+    int i = -s;   // i == -7
+    i = s + 8;    // i == 15
+    i = s + s;    // i == 14
+    i = 9 + s;    // i == 16
+    i = foo(s);   // implicit conversion to int
+}
+---
+)
+
-<h3>$(LNAME2 auto, Scope Classes)</h3>
-

trunk/docsrc/struct.dd

@@ -363 +363 @@
-    $(GLINK StructPostblit)
-    $(GLINK StructDestructor))
+$(V2
+    $(LINK2 class.html#AliasThis, $(I AliasThis))
+)
-
-$(GNAME StructAllocator):