Merge pull request #3834 from ntrel/implicit-conv

[spec/type] Document integer implicit conversions

Signed-off-by: Nicholas Wilson <thewilsonator@users.noreply.github.com>
Merged-on-behalf-of: Nicholas Wilson <thewilsonator@users.noreply.github.com>

Author: dlang-bot

spec/type.dd

@@ -458,23 +458,51 @@ void test()
     $(DDSUBLINK spec/expression, assignment_operator_expressions, operator assignment)
     is equivalent to `e = cast(E)(e + 4)`.)
 
-$(H3 $(LNAME2 disallowed-conversions, Preserving Bit Patterns))
+$(H3 $(LEGACY_LNAME2 disallowed-conversions, integer-conversions, Integer Type Conversions))
+
+    $(P An integer of type `I` implicitly converts to another integer type `J` when
+    `J.sizeof >= I.sizeof`.)
+
+$(SPEC_RUNNABLE_EXAMPLE_FAIL
+---
+void f(byte b, ubyte ub, short s)
+{
+    b = ub; // OK, bit pattern same
+    ub = b; // OK, bit pattern same
+    s = b; // OK, widening conversion
+    b = s; // error, implicit narrowing
+}
+---
+)
 
     $(P Integer values cannot be implicitly converted to another
-    type that cannot represent the integer bit pattern after integral
-    promotion. For example:)
+    type that cannot represent the integer bit pattern after
+    $(RELATIVE_LINK2 integer-promotions, integral promotion). For example:)
 
 $(SPEC_RUNNABLE_EXAMPLE_FAIL
 ---
-ubyte  u1 = -1;       // error, -1 cannot be represented in a ubyte
-ushort u2 = -1;       // error, -1 cannot be represented in a ushort
-uint   u3 = int(-1);  // ok, -1 can be represented in an int, which can be converted to a uint
-ulong  u4 = long(-1); // ok, -1 can be represented in a long, which can be converted to a ulong
+ubyte  u1 = -1; // error, -1 cannot be represented in a ubyte
+ushort u2 = -1; // error, -1 cannot be represented in a ushort
+uint   u3 = -1; // ok, -1 can be represented in an int, which can be converted to a uint
+ulong  u4 = -1; // ok, -1 can be represented in a long, which can be converted to a ulong
 ---
 )
 
-    * Floating point types cannot be implicitly converted to
-      integral types.
+$(H3 $(LNAME2 floating-point-conversions, Floating Point Type Conversions))
+
+    * Integral types implicitly convert to floating point types.
+    * Floating point types cannot be implicitly converted to integral types.
+
+    $(SPEC_RUNNABLE_EXAMPLE_FAIL
+    ---
+    void f(int i, float f)
+    {
+        f = i; // OK
+        i = f; // error
+    }
+    ---
+    )
+
     * Complex or imaginary floating point types cannot be implicitly converted
       to non-complex floating point types.
     * Non-complex floating point types cannot be implicitly converted to imaginary floating