all: gofmt

Gofmt to update doc comments to the new formatting.

For golang/go#51082.

Change-Id: I9a1c4b671c06820a1c383ee515f7884965fefa54
Reviewed-on: https://go-review.googlesource.com/c/sys/+/399602
Reviewed-by: Ian Lance Taylor <iant@google.com>
Auto-Submit: Russ Cox <rsc@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>

plan9/mksyscall.go

@@ -10,11 +10,11 @@ This program reads a file containing function prototypes
 (like syscall_plan9.go) and generates system call bodies.
 The prototypes are marked by lines beginning with "//sys"
 and read like func declarations if //sys is replaced by func, but:
-	* The parameter lists must give a name for each argument.
+  - The parameter lists must give a name for each argument.
     This includes return parameters.
-	* The parameter lists must give a type for each argument:
+  - The parameter lists must give a type for each argument:
     the (x, y, z int) shorthand is not allowed.
-	* If the return parameter is an error number, it must be named errno.
+  - If the return parameter is an error number, it must be named errno.
 
 A line beginning with //sysnb is like //sys, except that the
 goroutine will not be suspended during the execution of the system

plan9/syscall.go

@@ -113,5 +113,6 @@ func (tv *Timeval) Nano() int64 {
 
 // use is a no-op, but the compiler cannot see that it is.
 // Calling use(p) ensures that p is kept live until that point.
+//
 //go:noescape
 func use(p unsafe.Pointer)

plan9/syscall_plan9.go

@@ -115,6 +115,7 @@ func Write(fd int, p []byte) (n int, err error) {
 var ioSync int64
 
 //sys	fd2path(fd int, buf []byte) (err error)
+
 func Fd2path(fd int) (path string, err error) {
 	var buf [512]byte
 
@@ -126,6 +127,7 @@ func Fd2path(fd int) (path string, err error) {
 }
 
 //sys	pipe(p *[2]int32) (err error)
+
 func Pipe(p []int) (err error) {
 	if len(p) != 2 {
 		return syscall.ErrorString("bad arg in system call")
@@ -180,6 +182,7 @@ func (w Waitmsg) ExitStatus() int {
 }
 
 //sys	await(s []byte) (n int, err error)
+
 func Await(w *Waitmsg) (err error) {
 	var buf [512]byte
 	var f [5][]byte
@@ -301,42 +304,49 @@ func Getgroups() (gids []int, err error) {
 }
 
 //sys	open(path string, mode int) (fd int, err error)
+
 func Open(path string, mode int) (fd int, err error) {
 	fixwd()
 	return open(path, mode)
 }
 
 //sys	create(path string, mode int, perm uint32) (fd int, err error)
+
 func Create(path string, mode int, perm uint32) (fd int, err error) {
 	fixwd()
 	return create(path, mode, perm)
 }
 
 //sys	remove(path string) (err error)
+
 func Remove(path string) error {
 	fixwd()
 	return remove(path)
 }
 
 //sys	stat(path string, edir []byte) (n int, err error)
+
 func Stat(path string, edir []byte) (n int, err error) {
 	fixwd()
 	return stat(path, edir)
 }
 
 //sys	bind(name string, old string, flag int) (err error)
+
 func Bind(name string, old string, flag int) (err error) {
 	fixwd()
 	return bind(name, old, flag)
 }
 
 //sys	mount(fd int, afd int, old string, flag int, aname string) (err error)
+
 func Mount(fd int, afd int, old string, flag int, aname string) (err error) {
 	fixwd()
 	return mount(fd, afd, old, flag, aname)
 }
 
 //sys	wstat(path string, edir []byte) (err error)
+
 func Wstat(path string, edir []byte) (err error) {
 	fixwd()
 	return wstat(path, edir)

unix/internal/mkmerge/mkmerge.go

@@ -6,9 +6,11 @@
 // consts, funcs, and types into a common source file, per GOOS.
 //
 // Usage:
+//
 //	$ mkmerge -out MERGED FILE [FILE ...]
 //
 // Example:
+//
 //	# Remove all common consts, funcs, and types from zerrors_linux_*.go
 //	# and write the common code into zerrors_linux.go
 //	$ mkmerge -out zerrors_linux.go zerrors_linux_*.go

unix/mkasm_darwin.go

@@ -6,7 +6,7 @@
 // +build ignore
 
 // mkasm_darwin.go generates assembly trampolines to call libSystem routines from Go.
-//This program must be run after mksyscall.go.
+// This program must be run after mksyscall.go.
 package main
 
 import (

unix/mksyscall.go

@@ -10,11 +10,11 @@ This program reads a file containing function prototypes
 (like syscall_darwin.go) and generates system call bodies.
 The prototypes are marked by lines beginning with "//sys"
 and read like func declarations if //sys is replaced by func, but:
-	* The parameter lists must give a name for each argument.
+  - The parameter lists must give a name for each argument.
     This includes return parameters.
-	* The parameter lists must give a type for each argument:
+  - The parameter lists must give a type for each argument:
     the (x, y, z int) shorthand is not allowed.
-	* If the return parameter is an error number, it must be named errno.
+  - If the return parameter is an error number, it must be named errno.
 
 A line beginning with //sysnb is like //sys, except that the
 goroutine will not be suspended during the execution of the system

unix/mksyscall_aix_ppc.go

@@ -10,14 +10,14 @@ This program reads a file containing function prototypes
 (like syscall_aix.go) and generates system call bodies.
 The prototypes are marked by lines beginning with "//sys"
 and read like func declarations if //sys is replaced by func, but:
-	* The parameter lists must give a name for each argument.
+  - The parameter lists must give a name for each argument.
     This includes return parameters.
-	* The parameter lists must give a type for each argument:
+  - The parameter lists must give a type for each argument:
     the (x, y, z int) shorthand is not allowed.
-	* If the return parameter is an error number, it must be named err.
+  - If the return parameter is an error number, it must be named err.
-	* If go func name needs to be different than its libc name,
+  - If go func name needs to be different than its libc name,
-	* or the function is not in libc, name could be specified
+  - or the function is not in libc, name could be specified
-	* at the end, after "=" sign, like
+  - at the end, after "=" sign, like
     //sys	getsockopt(s int, level int, name int, val uintptr, vallen *_Socklen) (err error) = libsocket.getsockopt
 */
 package main

unix/syscall_aix.go

@@ -37,6 +37,7 @@ func Creat(path string, mode uint32) (fd int, err error) {
 }
 
 //sys	utimes(path string, times *[2]Timeval) (err error)
+
 func Utimes(path string, tv []Timeval) error {
 	if len(tv) != 2 {
 		return EINVAL
@@ -45,6 +46,7 @@ func Utimes(path string, tv []Timeval) error {
 }
 
 //sys	utimensat(dirfd int, path string, times *[2]Timespec, flag int) (err error)
+
 func UtimesNano(path string, ts []Timespec) error {
 	if len(ts) != 2 {
 		return EINVAL
@@ -300,11 +302,13 @@ func direntNamlen(buf []byte) (uint64, bool) {
 }
 
 //sys	getdirent(fd int, buf []byte) (n int, err error)
+
 func Getdents(fd int, buf []byte) (n int, err error) {
 	return getdirent(fd, buf)
 }
 
 //sys	wait4(pid Pid_t, status *_C_int, options int, rusage *Rusage) (wpid Pid_t, err error)
+
 func Wait4(pid int, wstatus *WaitStatus, options int, rusage *Rusage) (wpid int, err error) {
 	var status _C_int
 	var r Pid_t
@@ -372,6 +376,7 @@ func (w WaitStatus) TrapCause() int { return -1 }
 //sys	fcntl(fd int, cmd int, arg int) (val int, err error)
 
 //sys	fsyncRange(fd int, how int, start int64, length int64) (err error) = fsync_range
+
 func Fsync(fd int) error {
 	return fsyncRange(fd, O_SYNC, 0, 0)
 }
@@ -536,6 +541,7 @@ func Poll(fds []PollFd, timeout int) (n int, err error) {
 //sys	Getsystemcfg(label int) (n uint64)
 
 //sys	umount(target string) (err error)
+
 func Unmount(target string, flags int) (err error) {
 	if flags != 0 {
 		// AIX doesn't have any flags for umount.

unix/syscall_dragonfly.go

@@ -125,11 +125,13 @@ func Pipe2(p []int, flags int) (err error) {
 }
 
 //sys	extpread(fd int, p []byte, flags int, offset int64) (n int, err error)
+
 func pread(fd int, p []byte, offset int64) (n int, err error) {
 	return extpread(fd, p, 0, offset)
 }
 
 //sys	extpwrite(fd int, p []byte, flags int, offset int64) (n int, err error)
+
 func pwrite(fd int, p []byte, offset int64) (n int, err error) {
 	return extpwrite(fd, p, 0, offset)
 }

unix/syscall_openbsd.go

@@ -81,6 +81,7 @@ func Pipe(p []int) (err error) {
 }
 
 //sysnb	pipe2(p *[2]_C_int, flags int) (err error)
+
 func Pipe2(p []int, flags int) error {
 	if len(p) != 2 {
 		return EINVAL
@@ -95,6 +96,7 @@ func Pipe2(p []int, flags int) error {
 }
 
 //sys	Getdents(fd int, buf []byte) (n int, err error)
+
 func Getdirentries(fd int, buf []byte, basep *uintptr) (n int, err error) {
 	n, err = Getdents(fd, buf)
 	if err != nil || basep == nil {

windows/mkwinsyscall/mkwinsyscall.go

@@ -12,32 +12,34 @@ to standard output.
 The prototypes are marked by lines beginning with "//sys" and read
 like func declarations if //sys is replaced by func, but:
 
-* The parameter lists must give a name for each argument. This
+  - The parameter lists must give a name for each argument. This
     includes return parameters.
 
-* The parameter lists must give a type for each argument:
+  - The parameter lists must give a type for each argument:
     the (x, y, z int) shorthand is not allowed.
 
-* If the return parameter is an error number, it must be named err.
+  - If the return parameter is an error number, it must be named err.
 
-* If go func name needs to be different from its winapi dll name,
+  - If go func name needs to be different from its winapi dll name,
     the winapi name could be specified at the end, after "=" sign, like
     //sys LoadLibrary(libname string) (handle uint32, err error) = LoadLibraryA
 
-* Each function that returns err needs to supply a condition, that
+  - Each function that returns err needs to supply a condition, that
     return value of winapi will be tested against to detect failure.
     This would set err to windows "last-error", otherwise it will be nil.
     The value can be provided at end of //sys declaration, like
     //sys LoadLibrary(libname string) (handle uint32, err error) [failretval==-1] = LoadLibraryA
     and is [failretval==0] by default.
 
-* If the function name ends in a "?", then the function not existing is non-
+  - If the function name ends in a "?", then the function not existing is non-
     fatal, and an error will be returned instead of panicking.
 
 Usage:
+
 	mkwinsyscall [flags] [path ...]
 
 The flags are:
+
 	-output
 		Specify output file name (outputs to console if blank).
 	-trace

windows/registry/key.go

@@ -20,7 +20,6 @@
 //		log.Fatal(err)
 //	}
 //	fmt.Printf("Windows system root is %q\n", s)
-//
 package registry
 
 import (

windows/svc/debug/service.go

@@ -6,7 +6,6 @@
 // +build windows
 
 // Package debug provides facilities to execute svc.Handler on console.
-//
 package debug
 
 import (

windows/svc/eventlog/log.go

@@ -6,7 +6,6 @@
 // +build windows
 
 // Package eventlog implements access to Windows event log.
-//
 package eventlog
 
 import (

windows/svc/example/main.go

@@ -12,7 +12,6 @@
 // stop / start / pause / continue any service, and how to
 // write to event log. It also shows how to use debug
 // facilities available in debug package.
-//
 package main
 
 import (

windows/svc/mgr/mgr.go

@@ -9,7 +9,6 @@
 // It can be used to install and remove them. It can also start,
 // stop and pause them. The package can query / change current
 // service state and config parameters.
-//
 package mgr
 
 import (

windows/svc/service.go

@@ -6,7 +6,6 @@
 // +build windows
 
 // Package svc provides everything required to build Windows service.
-//
 package svc
 
 import (