1
0
mirror of https://github.com/golang/go synced 2024-11-24 10:00:12 -07:00

doc: only trim newlines in tmpltohtml, gofmt progs

R=golang-dev, r, r
CC=golang-dev
https://golang.org/cl/5530048
This commit is contained in:
Andrew Gerrand 2012-01-09 20:05:34 +11:00
parent c7e91724c0
commit 468e692e38
13 changed files with 43 additions and 29 deletions

View File

@ -20,7 +20,7 @@ occurs it calls <code>log.Fatal</code> to print the error message and stop.
</p> </p>
<pre><!--{{code "progs/error.go" `/func openFile/` `/STOP/`}} <pre><!--{{code "progs/error.go" `/func openFile/` `/STOP/`}}
-->f, err := os.Open(&#34;filename.ext&#34;) --> f, err := os.Open(&#34;filename.ext&#34;)
if err != nil { if err != nil {
log.Fatal(err) log.Fatal(err)
} }
@ -100,7 +100,7 @@ A caller passing a negative argument to <code>Sqrt</code> receives a non-nil
</p> </p>
<pre><!--{{code "progs/error.go" `/func printErr/` `/STOP/`}} <pre><!--{{code "progs/error.go" `/func printErr/` `/STOP/`}}
-->f, err := Sqrt(-1) --> f, err := Sqrt(-1)
if err != nil { if err != nil {
fmt.Println(err) fmt.Println(err)
}</pre> }</pre>
@ -125,7 +125,7 @@ rules and returns it as an <code>error</code> created by
</p> </p>
<pre><!--{{code "progs/error.go" `/fmtError/` `/STOP/`}} <pre><!--{{code "progs/error.go" `/fmtError/` `/STOP/`}}
-->if f &lt; 0 { --> if f &lt; 0 {
return 0, fmt.Errorf(&#34;math: square root of negative number %g&#34;, f) return 0, fmt.Errorf(&#34;math: square root of negative number %g&#34;, f)
}</pre> }</pre>
@ -177,7 +177,7 @@ messages:
</p> </p>
<pre><!--{{code "progs/error.go" `/func decodeError/` `/STOP/`}} <pre><!--{{code "progs/error.go" `/func decodeError/` `/STOP/`}}
-->if err := dec.Decode(&amp;val); err != nil { --> if err := dec.Decode(&amp;val); err != nil {
if serr, ok := err.(*json.SyntaxError); ok { if serr, ok := err.(*json.SyntaxError); ok {
line, col := findLine(f, serr.Offset) line, col := findLine(f, serr.Offset)
return fmt.Errorf(&#34;%s:%d:%d: %v&#34;, f.Name(), line, col, err) return fmt.Errorf(&#34;%s:%d:%d: %v&#34;, f.Name(), line, col, err)
@ -216,7 +216,7 @@ up otherwise.
</p> </p>
<pre><!--{{code "progs/error.go" `/func netError/` `/STOP/`}} <pre><!--{{code "progs/error.go" `/func netError/` `/STOP/`}}
-->if nerr, ok := err.(net.Error); ok &amp;&amp; nerr.Temporary() { --> if nerr, ok := err.(net.Error); ok &amp;&amp; nerr.Temporary() {
time.Sleep(1e9) time.Sleep(1e9)
continue continue
} }

View File

@ -44,7 +44,7 @@ call.
</p> </p>
<pre><!--{{code "progs/go1.go" `/greeting := ..byte/` `/append.*hello/`}} <pre><!--{{code "progs/go1.go" `/greeting := ..byte/` `/append.*hello/`}}
-->greeting := []byte{} --> greeting := []byte{}
greeting = append(greeting, []byte(&#34;hello &#34;)...)</pre> greeting = append(greeting, []byte(&#34;hello &#34;)...)</pre>
<p> <p>
@ -54,7 +54,7 @@ slice; the conversion is no longer necessary:
</p> </p>
<pre><!--{{code "progs/go1.go" `/append.*world/`}} <pre><!--{{code "progs/go1.go" `/append.*world/`}}
-->greeting = append(greeting, &#34;world&#34;...)</pre> --> greeting = append(greeting, &#34;world&#34;...)</pre>
<p> <p>
<em>Updating</em>: <em>Updating</em>:
@ -95,7 +95,7 @@ All four of the initializations in this example are legal; the last one was ille
</p> </p>
<pre><!--{{code "progs/go1.go" `/type Date struct/` `/STOP/`}} <pre><!--{{code "progs/go1.go" `/type Date struct/` `/STOP/`}}
-->type Date struct { --> type Date struct {
month string month string
day int day int
} }
@ -182,7 +182,7 @@ relatives now take and return a <code>rune</code>.
</p> </p>
<pre><!--{{code "progs/go1.go" `/STARTRUNE/` `/ENDRUNE/`}} <pre><!--{{code "progs/go1.go" `/STARTRUNE/` `/ENDRUNE/`}}
-->delta := &#39;δ&#39; // delta has type rune. --> delta := &#39;δ&#39; // delta has type rune.
var DELTA rune var DELTA rune
DELTA = unicode.ToUpper(delta) DELTA = unicode.ToUpper(delta)
epsilon := unicode.ToLower(DELTA + 1) epsilon := unicode.ToLower(DELTA + 1)
@ -231,7 +231,7 @@ function, <code>delete</code>. The call
</p> </p>
<pre><!--{{code "progs/go1.go" `/delete\(m, k\)/`}} <pre><!--{{code "progs/go1.go" `/delete\(m, k\)/`}}
-->delete(m, k)</pre> --> delete(m, k)</pre>
<p> <p>
will delete the map entry retrieved by the expression <code>m[k]</code>. will delete the map entry retrieved by the expression <code>m[k]</code>.
@ -258,7 +258,7 @@ Code should not assume that the elements are visited in any particular order.
</p> </p>
<pre><!--{{code "progs/go1.go" `/Sunday/` `/^ }/`}} <pre><!--{{code "progs/go1.go" `/Sunday/` `/^ }/`}}
-->m := map[string]int{&#34;Sunday&#34;: 0, &#34;Monday&#34;: 1} --> m := map[string]int{&#34;Sunday&#34;: 0, &#34;Monday&#34;: 1}
for name, value := range m { for name, value := range m {
// This loop should not assume Sunday will be visited first. // This loop should not assume Sunday will be visited first.
f(name, value) f(name, value)
@ -292,7 +292,7 @@ These examples illustrate the behavior.
</p> </p>
<pre><!--{{code "progs/go1.go" `/sa :=/` `/then sc.0. = 2/`}} <pre><!--{{code "progs/go1.go" `/sa :=/` `/then sc.0. = 2/`}}
-->sa := []int{1, 2, 3} --> sa := []int{1, 2, 3}
i := 0 i := 0
i, sa[i] = 1, 2 // sets i = 1, sa[0] = 2 i, sa[i] = 1, 2 // sets i = 1, sa[0] = 2
@ -409,7 +409,7 @@ As a result, structs and arrays can now be used as map keys:
</p> </p>
<pre><!--{{code "progs/go1.go" `/type Day struct/` `/Printf/`}} <pre><!--{{code "progs/go1.go" `/type Day struct/` `/Printf/`}}
-->type Day struct { --> type Day struct {
long string long string
short string short string
} }
@ -585,7 +585,7 @@ to turn a string into an error. It replaces the old <code>os.NewError</code>.
</p> </p>
<pre><!--{{code "progs/go1.go" `/ErrSyntax/`}} <pre><!--{{code "progs/go1.go" `/ErrSyntax/`}}
-->var ErrSyntax = errors.New(&#34;syntax error&#34;)</pre> --> var ErrSyntax = errors.New(&#34;syntax error&#34;)</pre>
<p> <p>
<em>Updating</em>: <em>Updating</em>:

View File

@ -119,8 +119,8 @@ Next up, here's a version of the Unix utility <code>echo(1)</code>:
-->package main -->package main
import ( import (
&#34;os&#34;
&#34;flag&#34; // command line option parser &#34;flag&#34; // command line option parser
&#34;os&#34;
) )
var omitNewline = flag.Bool(&#34;n&#34;, false, &#34;don&#39;t print final newline&#34;) var omitNewline = flag.Bool(&#34;n&#34;, false, &#34;don&#39;t print final newline&#34;)
@ -209,7 +209,7 @@ The <code>:=</code> operator is used a lot in Go to represent an initializing de
There's one in the <code>for</code> clause on the next line: There's one in the <code>for</code> clause on the next line:
<p> <p>
<pre><!--{{code "progs/echo.go" `/for/`}} <pre><!--{{code "progs/echo.go" `/for/`}}
-->for i := 0; i &lt; flag.NArg(); i++ {</pre> --> for i := 0; i &lt; flag.NArg(); i++ {</pre>
<p> <p>
The <code>flag</code> package has parsed the arguments and left the non-flag arguments The <code>flag</code> package has parsed the arguments and left the non-flag arguments
in a list that can be iterated over in the obvious way. in a list that can be iterated over in the obvious way.
@ -258,7 +258,7 @@ of course you can change a string <i>variable</i> simply by
reassigning it. This snippet from <code>strings.go</code> is legal code: reassigning it. This snippet from <code>strings.go</code> is legal code:
<p> <p>
<pre><!--{{code "progs/strings.go" `/hello/` `/ciao/`}} <pre><!--{{code "progs/strings.go" `/hello/` `/ciao/`}}
-->s := &#34;hello&#34; --> s := &#34;hello&#34;
if s[1] != &#39;e&#39; { if s[1] != &#39;e&#39; {
os.Exit(1) os.Exit(1)
} }
@ -811,8 +811,7 @@ func (r13 *rotate13) Read(b []byte) (ret int, err error) {
func (r13 *rotate13) String() string { func (r13 *rotate13) String() string {
return r13.source.String() return r13.source.String()
} }</pre>
// end of rotate13 implementation</pre>
<p> <p>
(The <code>rot13</code> function called in <code>Read</code> is trivial and not worth reproducing here.) (The <code>rot13</code> function called in <code>Read</code> is trivial and not worth reproducing here.)
<p> <p>
@ -990,7 +989,7 @@ can just say <code>%d</code>; <code>Printf</code> knows the size and signedness
integer and can do the right thing for you. The snippet integer and can do the right thing for you. The snippet
<p> <p>
<pre><!--{{code "progs/print.go" 10 11}} <pre><!--{{code "progs/print.go" 10 11}}
-->var u64 uint64 = 1&lt;&lt;64 - 1 --> var u64 uint64 = 1&lt;&lt;64 - 1
fmt.Printf(&#34;%d %d\n&#34;, u64, int64(u64))</pre> fmt.Printf(&#34;%d %d\n&#34;, u64, int64(u64))</pre>
<p> <p>
prints prints
@ -1003,7 +1002,7 @@ In fact, if you're lazy the format <code>%v</code> will print, in a simple
appropriate style, any value, even an array or structure. The output of appropriate style, any value, even an array or structure. The output of
<p> <p>
<pre><!--{{code "progs/print.go" 14 20}} <pre><!--{{code "progs/print.go" 14 20}}
-->type T struct { --> type T struct {
a int a int
b string b string
} }
@ -1025,7 +1024,7 @@ and adds a newline. The output of each of these two lines is identical
to that of the <code>Printf</code> call above. to that of the <code>Printf</code> call above.
<p> <p>
<pre><!--{{code "progs/print.go" 21 22}} <pre><!--{{code "progs/print.go" 21 22}}
-->fmt.Print(u64, &#34; &#34;, t, &#34; &#34;, a, &#34;\n&#34;) --> fmt.Print(u64, &#34; &#34;, t, &#34; &#34;, a, &#34;\n&#34;)
fmt.Println(u64, t, a)</pre> fmt.Println(u64, t, a)</pre>
<p> <p>
If you have your own type you'd like <code>Printf</code> or <code>Print</code> to format, If you have your own type you'd like <code>Printf</code> or <code>Print</code> to format,
@ -1442,10 +1441,10 @@ All that's left is to strobe the <code>quit</code> channel
at the end of main: at the end of main:
<p> <p>
<pre><!--{{code "progs/server1.go" `/adder,.quit/`}} <pre><!--{{code "progs/server1.go" `/adder,.quit/`}}
-->adder, quit := startServer(func(a, b int) int { return a + b })</pre> --> adder, quit := startServer(func(a, b int) int { return a + b })</pre>
... ...
<pre><!--{{code "progs/server1.go" `/quit....true/`}} <pre><!--{{code "progs/server1.go" `/quit....true/`}}
-->quit &lt;- true</pre> --> quit &lt;- true</pre>
<p> <p>
There's a lot more to Go programming and concurrent programming in general but this There's a lot more to Go programming and concurrent programming in general but this
quick tour should give you some of the basics. quick tour should give you some of the basics.

View File

@ -47,7 +47,8 @@ func (r13 *rotate13) Read(b []byte) (ret int, err error) {
func (r13 *rotate13) String() string { func (r13 *rotate13) String() string {
return r13.source.String() return r13.source.String()
} }
// end of rotate13 implementation
// end of rotate13 implementation OMIT
func cat(r reader) { func cat(r reader) {
const NBUF = 512 const NBUF = 512

View File

@ -35,6 +35,7 @@ func g(i int) {
fmt.Println("Printing in g", i) fmt.Println("Printing in g", i)
g(i + 1) g(i + 1)
} }
// STOP OMIT // STOP OMIT
// Revised version. // Revised version.
@ -53,4 +54,5 @@ func CopyFile(dstName, srcName string) (written int64, err error) {
return io.Copy(dst, src) return io.Copy(dst, src)
} }
// STOP OMIT // STOP OMIT

View File

@ -5,8 +5,8 @@
package main package main
import ( import (
"os"
"flag" // command line option parser "flag" // command line option parser
"os"
) )
var omitNewline = flag.Bool("n", false, "don't print final newline") var omitNewline = flag.Bool("n", false, "don't print final newline")

View File

@ -38,12 +38,14 @@ type errorString struct {
func (e *errorString) Error() string { func (e *errorString) Error() string {
return e.s return e.s
} }
// STOP OMIT // STOP OMIT
// New returns an error that formats as the given text. // New returns an error that formats as the given text.
func New(text string) error { func New(text string) error {
return &errorString{text} return &errorString{text}
} }
// STOP OMIT // STOP OMIT
func Sqrt(f float64) (float64, error) { func Sqrt(f float64) (float64, error) {
@ -53,6 +55,7 @@ func Sqrt(f float64) (float64, error) {
// implementation // implementation
return 0, nil // OMIT return 0, nil // OMIT
} }
// STOP OMIT // STOP OMIT
func printErr() (int, error) { // OMIT func printErr() (int, error) { // OMIT
@ -74,6 +77,7 @@ type NegativeSqrtError float64
func (f NegativeSqrtError) Error() string { func (f NegativeSqrtError) Error() string {
return fmt.Sprintf("math: square root of negative number %g", float64(f)) return fmt.Sprintf("math: square root of negative number %g", float64(f))
} }
// STOP OMIT // STOP OMIT
type SyntaxError struct { type SyntaxError struct {
@ -82,6 +86,7 @@ type SyntaxError struct {
} }
func (e *SyntaxError) Error() string { return e.msg } func (e *SyntaxError) Error() string { return e.msg }
// STOP OMIT // STOP OMIT
func decodeError(dec *json.Decoder, val struct{}) error { // OMIT func decodeError(dec *json.Decoder, val struct{}) error { // OMIT

View File

@ -27,6 +27,7 @@ func viewRecord(w http.ResponseWriter, r *http.Request) {
http.Error(w, err.Error(), 500) http.Error(w, err.Error(), 500)
} }
} }
// STOP OMIT // STOP OMIT
type ap struct{} type ap struct{}

View File

@ -14,6 +14,7 @@ import (
func init() { func init() {
http.Handle("/view", appHandler(viewRecord)) http.Handle("/view", appHandler(viewRecord))
} }
// STOP OMIT // STOP OMIT
func viewRecord(w http.ResponseWriter, r *http.Request) error { func viewRecord(w http.ResponseWriter, r *http.Request) error {
@ -25,6 +26,7 @@ func viewRecord(w http.ResponseWriter, r *http.Request) error {
} }
return viewTemplate.Execute(w, record) return viewTemplate.Execute(w, record)
} }
// STOP OMIT // STOP OMIT
type appHandler func(http.ResponseWriter, *http.Request) error type appHandler func(http.ResponseWriter, *http.Request) error
@ -34,6 +36,7 @@ func (fn appHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
http.Error(w, err.Error(), 500) http.Error(w, err.Error(), 500)
} }
} }
// STOP OMIT // STOP OMIT
type ap struct{} type ap struct{}

View File

@ -16,6 +16,7 @@ type appError struct {
Message string Message string
Code int Code int
} }
// STOP OMIT // STOP OMIT
type appHandler func(http.ResponseWriter, *http.Request) *appError type appHandler func(http.ResponseWriter, *http.Request) *appError
@ -27,6 +28,7 @@ func (fn appHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
http.Error(w, e.Message, e.Code) http.Error(w, e.Message, e.Code)
} }
} }
// STOP OMIT // STOP OMIT
func viewRecord(w http.ResponseWriter, r *http.Request) *appError { func viewRecord(w http.ResponseWriter, r *http.Request) *appError {
@ -41,6 +43,7 @@ func viewRecord(w http.ResponseWriter, r *http.Request) *appError {
} }
return nil return nil
} }
// STOP OMIT // STOP OMIT
func init() { func init() {

View File

@ -147,6 +147,7 @@ type SyntaxError struct {
func (se *SyntaxError) Error() string { func (se *SyntaxError) Error() string {
return fmt.Sprintf("%s:%d: %s", se.File, se.Line, se.Message) return fmt.Sprintf("%s:%d: %s", se.File, se.Line, se.Message)
} }
// END ERROR EXAMPLE OMIT // END ERROR EXAMPLE OMIT
func errorExample() { func errorExample() {

View File

@ -5,8 +5,8 @@
package main package main
import ( import (
"fmt"
"./sort" "./sort"
"fmt"
) )
func ints() { func ints() {
@ -61,7 +61,6 @@ func days() {
fmt.Printf("\n") fmt.Printf("\n")
} }
func main() { func main() {
ints() ints()
strings() strings()

View File

@ -114,7 +114,7 @@ func code(file string, arg ...interface{}) (string, error) {
return "", fmt.Errorf("incorrect code invocation: code %q %q", file, arg) return "", fmt.Errorf("incorrect code invocation: code %q %q", file, arg)
} }
// Trim spaces from output. // Trim spaces from output.
text = strings.TrimSpace(text) text = strings.Trim(text, "\n")
// Replace tabs by spaces, which work better in HTML. // Replace tabs by spaces, which work better in HTML.
text = strings.Replace(text, "\t", " ", -1) text = strings.Replace(text, "\t", " ", -1)
// Escape the program text for HTML. // Escape the program text for HTML.