From b5ff30212690193a245c6b994a7f1413e24caae5 Mon Sep 17 00:00:00 2001
From: Martin Tournoij <martin@arp242.net>
Date: Wed, 10 Aug 2022 18:33:25 +0200
Subject: [PATCH] Clarify doc comment on WatchList()

---
 backend_inotify.go | 2 +-
 backend_kqueue.go  | 2 +-
 backend_windows.go | 2 +-
 mkdoc.zsh          | 6 ++++++
 4 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/backend_inotify.go b/backend_inotify.go
index 74441914..855e6540 100644
--- a/backend_inotify.go
+++ b/backend_inotify.go
@@ -312,7 +312,7 @@ func (w *Watcher) Remove(name string) error {
 	return nil
 }
 
-// WatchList returns the directories and files that are being monitered.
+// WatchList returns all paths added with Add() (and are not yet removed).
 func (w *Watcher) WatchList() []string {
 	w.mu.Lock()
 	defer w.mu.Unlock()
diff --git a/backend_kqueue.go b/backend_kqueue.go
index feb57050..409c645d 100644
--- a/backend_kqueue.go
+++ b/backend_kqueue.go
@@ -332,7 +332,7 @@ func (w *Watcher) Remove(name string) error {
 	return nil
 }
 
-// WatchList returns the directories and files that are being monitered.
+// WatchList returns all paths added with Add() (and are not yet removed).
 func (w *Watcher) WatchList() []string {
 	w.mu.Lock()
 	defer w.mu.Unlock()
diff --git a/backend_windows.go b/backend_windows.go
index c52272b2..a2540539 100644
--- a/backend_windows.go
+++ b/backend_windows.go
@@ -252,7 +252,7 @@ func (w *Watcher) Remove(name string) error {
 	return <-in.reply
 }
 
-// WatchList returns the directories and files that are being monitered.
+// WatchList returns all paths added with Add() (and are not yet removed).
 func (w *Watcher) WatchList() []string {
 	w.mu.Lock()
 	defer w.mu.Unlock()
diff --git a/mkdoc.zsh b/mkdoc.zsh
index fd44b253..b6dff6e1 100755
--- a/mkdoc.zsh
+++ b/mkdoc.zsh
@@ -119,6 +119,11 @@ close=$(<<EOF
 EOF
 )
 
+watchlist=$(<<EOF
+// WatchList returns all paths added with Add() (and are not yet removed).
+EOF
+)
+
 events=$(<<EOF
 	// Events sends the filesystem change events.
 	//
@@ -194,5 +199,6 @@ set-cmt '^func NewWatcher('                 $new
 set-cmt '^func (w \*Watcher) Add('          $add
 set-cmt '^func (w \*Watcher) Remove('       $remove
 set-cmt '^func (w \*Watcher) Close('        $close
+set-cmt '^func (w \*Watcher) WatchList('    $watchlist
 set-cmt '^[[:space:]]*Events *chan Event$'  $events
 set-cmt '^[[:space:]]*Errors *chan error$'  $errors