cmd/doc: incorrect text wrapping on 80 column terminals

[xi2]

I use cmd/doc on an 80 column terminal and I find it doesn't wrap correctly. For example:

$ doc os.truncate
func Truncate(name string, size int64) error

    Truncate changes the size of the named file. If the file is a symbolic link,
 it
    changes the size of the link's target. If there is an error, it will be of t
ype
    *PathError.

The following patch seems to fix it for me:

--- a/src/cmd/doc/pkg.go
+++ b/src/cmd/doc/pkg.go
@@ -135,7 +135,7 @@
                }
                if comment != "" {
                        pkg.newlines(2) // Guarantee blank line before comment.
-                       doc.ToText(&pkg.buf, comment, "    ", "\t", 80)
+                       doc.ToText(&pkg.buf, comment, "    ", "\t", 76)
                }
                pkg.newlines(1)
        }

I then get:

func Truncate(name string, size int64) error

    Truncate changes the size of the named file. If the file is a symbolic link,
    it changes the size of the link's target. If there is an error, it will be
    of type *PathError.

[robpike]

I find it really really hard to care about this, but you're probably right that it should be changed.

I have not used keypunch cards for almost 40 years but their influence on my life is incessant and overbearing.

[gopherbot]

CL https://golang.org/cl/12011 mentions this issue.