Merge branch 'master' into dev-Kovpak-regexp

Author: cn0047

.github/ISSUE_TEMPLATE

@@ -1,24 +1,36 @@
-Please answer these questions before submitting your issue. Thanks!
-
+<!-- Please answer these questions before submitting your issue. Thanks! -->
 
 ### What version of Go are you using (`go version`)?
 
+<pre>
+$ go version
+
+</pre>
 
 ### Does this issue reproduce with the latest release?
 
 
+
 ### What operating system and processor architecture are you using (`go env`)?
 
+<details><summary><code>go env</code> Output</summary><br><pre>
+$ go env
+
+</pre></details>
 
 ### What did you do?
 
+<!--
 If possible, provide a recipe for reproducing the error.
 A complete runnable program is good.
 A link on play.golang.org is best.
+-->
+
 
 
 ### What did you expect to see?
 
 
+
 ### What did you see instead?
 

doc/asm.html

@@ -740,6 +740,7 @@ <h3 id="arm64">ARM64</h3>
 
 <p>
 <code>R18</code> is the "platform register", reserved on the Apple platform.
+To prevent accidental misuse, the register is named <code>R18_PLATFORM</code>.
 <code>R27</code> and <code>R28</code> are reserved by the compiler and linker.
 <code>R29</code> is the frame pointer.
 <code>R30</code> is the link register.

doc/contribute.html

@@ -393,8 +393,8 @@ <h2 id="sending_a_change_gerrit">Sending a change via Gerrit</h2>
 <p>
 It is not possible to fully sync Gerrit and GitHub, at least at the moment,
 so we recommend learning Gerrit.
-It's different but powerful and familiarity
-with help you understand the flow.
+It's different but powerful and familiarity with it will help you understand
+the flow.
 </p>
 
 <h3>Overview</h3>

doc/devel/release.html

@@ -41,6 +41,14 @@ <h3 id="go1.11.minor">Minor revisions</h3>
 1.11.1 milestone</a> on our issue tracker for details.
 </p>
 
+<p>
+go1.11.2 (released 2018/11/02) includes fixes to the compiler, linker,
+documentation, go command, and the <code>database/sql</code> and
+<code>go/types</code> packages.
+See the <a href="https://github.com/golang/go/issues?q=milestone%3AGo1.11.2">Go
+1.11.2 milestone</a> on our issue tracker for details.
+</p>
+
 <h2 id="go1.10">go1.10 (released 2018/02/16)</h2>
 
 <p>
@@ -83,6 +91,13 @@ <h3 id="go1.10.minor">Minor revisions</h3>
 1.10.4 milestone</a> on our issue tracker for details.
 </p>
 
+<p>
+go1.10.5 (released 2018/11/02) includes fixes to the go command, linker, runtime
+and the <code>database/sql</code> package.
+See the <a href="https://github.com/golang/go/issues?q=milestone%3AGo1.10.5">Go
+1.10.5 milestone</a> on our issue tracker for details.
+</p>
+
 <h2 id="go1.9">go1.9 (released 2017/08/24)</h2>
 
 <p>

doc/effective_go.html

@@ -246,14 +246,16 @@ <h2 id="commentary">Commentary</h2>
 
 <p>
 If every doc comment begins with the name of the item it describes,
-the output of <code>godoc</code> can usefully be run through <code>grep</code>.
+you can use the <a href="/cmd/go/#hdr-Show_documentation_for_package_or_symbol">doc</a>
+subcommand of the <a href="/cmd/go/">go</a> tool
+and run the output through <code>grep</code>.
 Imagine you couldn't remember the name "Compile" but were looking for
 the parsing function for regular expressions, so you ran
 the command,
 </p>
 
 <pre>
-$ godoc regexp | grep -i parse
+$ go doc -all regexp | grep -i parse
 </pre>
 
 <p>
@@ -264,10 +266,10 @@ <h2 id="commentary">Commentary</h2>
 </p>
 
 <pre>
-$ godoc regexp | grep parse
+$ go doc -all regexp | grep -i parse
     Compile parses a regular expression and returns, if successful, a Regexp
+    MustCompile is like Compile but panics if the expression cannot be parsed.
     parsed. It simplifies safe initialization of global variables holding
-    cannot be parsed. It simplifies safe initialization of global variables
 $
 </pre>