From 0225f4b0b3def31f7d09dbaaf14558e969c343b2 Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Tue, 16 Apr 2019 18:01:50 +0200
Subject: [PATCH] cosmetics

---
 Doc/Sd1/languageFundamentals.xml | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/Doc/Sd1/languageFundamentals.xml b/Doc/Sd1/languageFundamentals.xml
index 9d63ea4a0..1c78d3796 100644
--- a/Doc/Sd1/languageFundamentals.xml
+++ b/Doc/Sd1/languageFundamentals.xml
@@ -3152,15 +3152,16 @@ System.out.println("Maximum short value:" + MAXIMUM);</programlisting>
             MAXIMUM = 0B00000000_00000000_01111111_11111111;
 ...</programlisting>
 
-            <para>The second 0B01111111_11111111 <code language="java"
+            <para>The second <code language="java"
             xlink:href="https://docs.oracle.com/javase/specs/jls/se7/html/jls-4.html#jls-4.2.1-100-C">int</code>
-            literal representing 32767 is perfectly assignable to a <code
-            language="java"
+            literal 0B01111111_11111111 representing 32767 is perfectly
+            assignable to a <code language="java"
             xlink:href="https://docs.oracle.com/javase/specs/jls/se7/html/jls-4.html#jls-4.2.1-100-B">short</code>
-            variable representing its maximum value as being intended.</para>
+            variable representing its maximum possible value as being
+            intended.</para>
 
-            <para>On the contrary the binary <code language="java">int</code>
-            value <code
+            <para>On the contrary the four-byte two complement <code
+            language="java">int</code> value <code
             language="java">00000000_00000000_10000000_00000000</code>
             evaluates to <inlineequation>
                 <m:math display="inline">
@@ -3170,9 +3171,11 @@ System.out.println("Maximum short value:" + MAXIMUM);</programlisting>
                     <m:mi>15</m:mi>
                   </m:msup>
                 </m:math>
-              </inlineequation> (equal to 32768) rather then the intended
-            two-byte two-complement <code language="java">short</code> value
-            -32768 (or <inlineequation>
+              </inlineequation> (equal to 32768). But omitting the two
+            leftmost bytes consisting of zero values the remaining two-byte
+            two complement short value <code
+            language="java">10000000_00000000</code> represents -32768 (or
+            <inlineequation>
                 <m:math display="inline">
                   <m:mrow>
                     <m:mo>-</m:mo>
@@ -3186,8 +3189,7 @@ System.out.println("Maximum short value:" + MAXIMUM);</programlisting>
                 </m:math>
               </inlineequation>).</para>
 
-            <para>Avoiding this error requires representing the value
-            <inlineequation>
+            <para>Avoiding this error requires representing <inlineequation>
                 <m:math display="inline">
                   <m:mrow>
                     <m:mo>-</m:mo>
-- 
GitLab