Few more tiny doc fixes >_<

backend_fen.go

@@ -123,11 +123,11 @@ type Watcher struct {
 
 	// Errors sends any errors.
 	//
-	// [ErrEventOverflow] is used to indicate there are too many events:
+	// ErrEventOverflow is used to indicate there are too many events:
 	//
-	//  - inotify: there are too many queued events (fs.inotify.max_queued_events sysctl)
-	//  - windows: The buffer size is too small; [WithBufferSize] can be used to increase it.
-	//  - kqueue, fen: not used.
+	//  - inotify:      There are too many queued events (fs.inotify.max_queued_events sysctl)
+	//  - windows:      The buffer size is too small; WithBufferSize() can be used to increase it.
+	//  - kqueue, fen:  Not used.
 	Errors chan error
 
 	mu      sync.Mutex
@@ -142,7 +142,7 @@ func NewWatcher() (*Watcher, error) {
 	return NewBufferedWatcher(0)
 }
 
-// NewBufferedWatcher creates a new Watcher with a buffered [Watcher.Events]
+// NewBufferedWatcher creates a new Watcher with a buffered Watcher.Events
 // channel.
 //
 // The main use case for this is situations with a very large number of events

backend_inotify.go

@@ -126,11 +126,11 @@ type Watcher struct {
 
 	// Errors sends any errors.
 	//
-	// [ErrEventOverflow] is used to indicate there are too many events:
+	// ErrEventOverflow is used to indicate there are too many events:
 	//
-	//  - inotify: there are too many queued events (fs.inotify.max_queued_events sysctl)
-	//  - windows: The buffer size is too small; [WithBufferSize] can be used to increase it.
-	//  - kqueue, fen: not used.
+	//  - inotify:      There are too many queued events (fs.inotify.max_queued_events sysctl)
+	//  - windows:      The buffer size is too small; WithBufferSize() can be used to increase it.
+	//  - kqueue, fen:  Not used.
 	Errors chan error
 
 	// Store fd here as os.File.Read() will no longer return on close after
@@ -241,7 +241,7 @@ func NewWatcher() (*Watcher, error) {
 	return NewBufferedWatcher(0)
 }
 
-// NewBufferedWatcher creates a new Watcher with a buffered [Watcher.Events]
+// NewBufferedWatcher creates a new Watcher with a buffered Watcher.Events
 // channel.
 //
 // The main use case for this is situations with a very large number of events

backend_kqueue.go

@@ -123,11 +123,11 @@ type Watcher struct {
 
 	// Errors sends any errors.
 	//
-	// [ErrEventOverflow] is used to indicate there are too many events:
+	// ErrEventOverflow is used to indicate there are too many events:
 	//
-	//  - inotify: there are too many queued events (fs.inotify.max_queued_events sysctl)
-	//  - windows: The buffer size is too small; [WithBufferSize] can be used to increase it.
-	//  - kqueue, fen: not used.
+	//  - inotify:      There are too many queued events (fs.inotify.max_queued_events sysctl)
+	//  - windows:      The buffer size is too small; WithBufferSize() can be used to increase it.
+	//  - kqueue, fen:  Not used.
 	Errors chan error
 
 	done         chan struct{}
@@ -153,7 +153,7 @@ func NewWatcher() (*Watcher, error) {
 	return NewBufferedWatcher(0)
 }
 
-// NewBufferedWatcher creates a new Watcher with a buffered [Watcher.Events]
+// NewBufferedWatcher creates a new Watcher with a buffered Watcher.Events
 // channel.
 //
 // The main use case for this is situations with a very large number of events

backend_other.go

@@ -115,11 +115,11 @@ type Watcher struct {
 
 	// Errors sends any errors.
 	//
-	// [ErrEventOverflow] is used to indicate there are too many events:
+	// ErrEventOverflow is used to indicate there are too many events:
 	//
-	//  - inotify: there are too many queued events (fs.inotify.max_queued_events sysctl)
-	//  - windows: The buffer size is too small; [WithBufferSize] can be used to increase it.
-	//  - kqueue, fen: not used.
+	//  - inotify:      There are too many queued events (fs.inotify.max_queued_events sysctl)
+	//  - windows:      The buffer size is too small; WithBufferSize() can be used to increase it.
+	//  - kqueue, fen:  Not used.
 	Errors chan error
 }
 
@@ -128,7 +128,7 @@ func NewWatcher() (*Watcher, error) {
 	return nil, errors.New("fsnotify not supported on the current platform")
 }
 
-// NewBufferedWatcher creates a new Watcher with a buffered [Watcher.Events]
+// NewBufferedWatcher creates a new Watcher with a buffered Watcher.Events
 // channel.
 //
 // The main use case for this is situations with a very large number of events

backend_windows.go

@@ -131,11 +131,11 @@ type Watcher struct {
 
 	// Errors sends any errors.
 	//
-	// [ErrEventOverflow] is used to indicate there are too many events:
+	// ErrEventOverflow is used to indicate there are too many events:
 	//
-	//  - inotify: there are too many queued events (fs.inotify.max_queued_events sysctl)
-	//  - windows: The buffer size is too small; [WithBufferSize] can be used to increase it.
-	//  - kqueue, fen: not used.
+	//  - inotify:      There are too many queued events (fs.inotify.max_queued_events sysctl)
+	//  - windows:      The buffer size is too small; WithBufferSize() can be used to increase it.
+	//  - kqueue, fen:  Not used.
 	Errors chan error
 
 	port  windows.Handle // Handle to completion port
@@ -152,7 +152,7 @@ func NewWatcher() (*Watcher, error) {
 	return NewBufferedWatcher(50)
 }
 
-// NewBufferedWatcher creates a new Watcher with a buffered [Watcher.Events]
+// NewBufferedWatcher creates a new Watcher with a buffered Watcher.Events
 // channel.
 //
 // The main use case for this is situations with a very large number of events

mkdoc.zsh

@@ -80,7 +80,7 @@ EOF
 )
 
 newbuffered=$(<<EOF
-// NewBufferedWatcher creates a new Watcher with a buffered [Watcher.Events]
+// NewBufferedWatcher creates a new Watcher with a buffered Watcher.Events
 // channel.
 //
 // The main use case for this is situations with a very large number of events
@@ -211,11 +211,11 @@ EOF
 errors=$(<<EOF
 	// Errors sends any errors.
 	//
-	// [ErrEventOverflow] is used to indicate there are too many events:
+	// ErrEventOverflow is used to indicate there are too many events:
 	//
-	//  - inotify: there are too many queued events (fs.inotify.max_queued_events sysctl)
-	//  - windows: The buffer size is too small; [WithBufferSize] can be used to increase it.
-	//  - kqueue, fen: not used.
+	//  - inotify:      There are too many queued events (fs.inotify.max_queued_events sysctl)
+	//  - windows:      The buffer size is too small; WithBufferSize() can be used to increase it.
+	//  - kqueue, fen:  Not used.
 EOF
 )