tutorial: show how to compile helloworld3, which depends on ./file

make shell prompts consistent

R=rsc
CC=golang-dev
https://golang.org/cl/1824042

diff --git a/doc/go_tutorial.html b/doc/go_tutorial.html
index b16f320178329992d09b0236edc95f5747229b4e..4c91a542421647dee88679f335244a03a15391ce 100644 (file)
--- a/doc/go_tutorial.html
+++ b/doc/go_tutorial.html
@@ -650,20 +650,22 @@ We can now use our new package:
 21    }
 </pre>
 <p>
-The ''<code>./</code>'' in the import of ''<code>./file</code>'' tells the
-compiler to use the ''<code>file</code>'' package in the current directory
-rather than something from the directory of installed packages.
-</p>
+The ''<code>./</code>'' in the import of ''<code>./file</code>'' tells the compiler
+to use our own package rather than
+something from the directory of installed packages.
+(Also, ''<code>file.go</code>'' must be compiled before we can import the
+package.)
 <p>
-You must compile ''<code>file.go</code>'' before any package that imports it.
-<p>
-Finally we can run the program:
+Now we can compile and run the program:
 <p>
 <pre>
-    % helloworld3
+    $ 6g file.go                       # compile file package
+    $ 6g helloworld3.go                # compile main package
+    $ 6l -o helloworld3 helloworld3.6  # link - no need to mention "file"
+    $ helloworld3
     hello, world
     can't open file; err=No such file or directory
-    %
+    $
 </pre>
 <p>
 <h2>Rotting cats</h2>
@@ -827,11 +829,11 @@ even though under the covers it holds a pointer to a <code>struct</code>.
 Here it is in action:
 <p>
 <pre>
-    % echo abcdefghijklmnopqrstuvwxyz | ./cat
+    $ echo abcdefghijklmnopqrstuvwxyz | ./cat
     abcdefghijklmnopqrstuvwxyz
-    % echo abcdefghijklmnopqrstuvwxyz | ./cat --rot13
+    $ echo abcdefghijklmnopqrstuvwxyz | ./cat --rot13
     nopqrstuvwxyzabcdefghijklm
-    %
+    $
 </pre>
 <p>
 Fans of dependency injection may take cheer from how easily interfaces

diff --git a/doc/go_tutorial.txt b/doc/go_tutorial.txt
index 6ab6094c0297eb99aa09bb8a05581e8ff5701c5a..bcea0db2b5ffb364b0de6d69001d303447ab6cf6 100644 (file)
--- a/doc/go_tutorial.txt
+++ b/doc/go_tutorial.txt
@@ -471,15 +471,21 @@ We can now use our new package:
 
 --PROG progs/helloworld3.go /package/ END
 
-The ''"./"'' in the import of ''"./file"'' tells the compiler to use our own package rather than
+The ''"./"'' in the import of ''"./file"'' tells the compiler
+to use our own package rather than
 something from the directory of installed packages.
+(Also, ''"file.go"'' must be compiled before we can import the
+package.)
 
-Finally we can run the program:
+Now we can compile and run the program:
 
-       % helloworld3
+       $ 6g file.go                       # compile file package
+       $ 6g helloworld3.go                # compile main package
+       $ 6l -o helloworld3 helloworld3.6  # link - no need to mention "file"
+       $ helloworld3
        hello, world
        can't open file; err=No such file or directory
-       %
+       $
 
 Rotting cats
 ----
@@ -549,11 +555,11 @@ even though under the covers it holds a pointer to a "struct".
 Here it is in action:
 
 <pre>
-       % echo abcdefghijklmnopqrstuvwxyz | ./cat
+       $ echo abcdefghijklmnopqrstuvwxyz | ./cat
        abcdefghijklmnopqrstuvwxyz
-       % echo abcdefghijklmnopqrstuvwxyz | ./cat --rot13
+       $ echo abcdefghijklmnopqrstuvwxyz | ./cat --rot13
        nopqrstuvwxyzabcdefghijklm
-       %
+       $
 </pre>
 
 Fans of dependency injection may take cheer from how easily interfaces