diff --git a/Doc/Sd1/objectsClasses.xml b/Doc/Sd1/objectsClasses.xml index ca0118d682cb4ef390643493266b8282eec4f6c5..3b6387a4ab003686a5f3f1d407c22b8cb4ce056c 100644 --- a/Doc/Sd1/objectsClasses.xml +++ b/Doc/Sd1/objectsClasses.xml @@ -376,7 +376,8 @@ public class Q {<lineannotation>Class def</lineannotation> </tr> <tr> - <td valign="top"><programlisting language="java">import java.util.*; + <td valign="top"><programlisting language="none">import java.util.<emphasis + role="red">*</emphasis>; public class Q { public static void main(String[] args) { @@ -385,8 +386,9 @@ public class Q { } }</programlisting></td> - <td valign="top"><programlisting language="java">import java.util.Date; -import java.util.Scanner; + <td valign="top"><programlisting language="none">import java.util.<emphasis + role="red">Date</emphasis>; +import java.util.<emphasis role="red">Scanner</emphasis>; public class Q { public static void main(String[] args) { @@ -401,15 +403,46 @@ public class Q { <figure xml:id="sd1_fig_javaDotLangNoImportRequired"> <title>Classes from <package>java.lang</package></title> - <programlisting language="java">import java.lang.String; // Not required -import java.util.Scanner; // Required + <programlisting language="none">import <emphasis role="red">java.lang</emphasis>.String; <co + linkends="sd1_fig_javaDotLangNoImportRequired-1.2" + xml:id="sd1_fig_javaDotLangNoImportRequired-1.2-co"/> // Optional +import <emphasis role="red">java.util</emphasis>.Scanner;<co + linkends="sd1_fig_javaDotLangNoImportRequired-2.2" + xml:id="sd1_fig_javaDotLangNoImportRequired-2.2-co"/> // Required public class Q { public static void main(String[] args) { String message = "Hello!"; - Scanner s = new Scanner(System.in); + Scanner <co linkends="sd1_fig_javaDotLangNoImportRequired-3" + xml:id="sd1_fig_javaDotLangNoImportRequired-3-co"/> s = new Scanner(System.in); } }</programlisting> + + <calloutlist> + <callout arearefs="sd1_fig_javaDotLangNoImportRequired-1.2-co" + xml:id="sd1_fig_javaDotLangNoImportRequired-1.2"> + <para>Classes belonging to the <package + xlink:href="https://docs.oracle.com/javase/9/docs/api/java/lang/package-summary.html">java.lang</package> + package are being imported automatically.</para> + </callout> + + <callout arearefs="sd1_fig_javaDotLangNoImportRequired-2.2-co" + xml:id="sd1_fig_javaDotLangNoImportRequired-2.2"> + <para>The <classname + xlink:href="https://docs.oracle.com/javase/9/docs/api/java/util/Scanner.html">Scanner</classname> + class belongs to the <package + xlink:href="https://docs.oracle.com/javase/9/docs/api/java/util/package-summary.html">java.util</package> + package and must thus be imported.</para> + </callout> + + <callout arearefs="sd1_fig_javaDotLangNoImportRequired-3-co" + xml:id="sd1_fig_javaDotLangNoImportRequired-3"> + <para>Without the import <classname>java.util.Scanner</classname> + statement we need the fully qualified class name:</para> + + <programlisting language="java">java.util.Scanner s = new java.util.Scanner(System.in);</programlisting> + </callout> + </calloutlist> </figure> <figure xml:id="sd1_fig_package2directory">