langref: more explicitly document how enum overriding works

1 files changed, 17 insertions, 2 deletions

diff --git a/doc/langref.html.in b/doc/langref.html.in
index 4f39ad72dd..8ba932c2bc 100644
--- a/doc/langref.html.in
+++ b/doc/langref.html.in
@@ -3633,9 +3633,8 @@ const Value = enum(u2) {
     one,
     two,
 };
-
 // Now you can cast between u2 and Value.
-// The ordinal value starts from 0, counting up for each member.
+// The ordinal value starts from 0, counting up by 1 from the previous member.
 test "enum ordinal value" {
     try expect(@enumToInt(Value.zero) == 0);
     try expect(@enumToInt(Value.one) == 1);
@@ -3654,6 +3653,22 @@ test "set enum ordinal value" {
     try expect(@enumToInt(Value2.million) == 1000000);
 }
 
+// You can also override only some values.
+const Value3 = enum(u4) {
+    a,
+    b = 8,
+    c,
+    d = 4,
+    e,
+};
+test "enum implicit ordinal values and overridden values" {
+    try expect(@enumToInt(Value3.a) == 0);
+    try expect(@enumToInt(Value3.b) == 8);
+    try expect(@enumToInt(Value3.c) == 9);
+    try expect(@enumToInt(Value3.d) == 4);
+    try expect(@enumToInt(Value3.e) == 5);
+}
+
 // Enums can have methods, the same as structs and unions.
 // Enum methods are not special, they are only namespaced
 // functions that you can call with dot syntax.