Tweak docs a bit

diff --git a/README.md b/README.md
index bd2f76fa9fe78844c774c325e8e04fc588ca2ee7..91080ba24fdca12fe7597a7c3c055fe02d2eb36e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,24 +4,20 @@ Windows, Linux, macOS, BSD, and illumos.
 Go 1.16 or newer is required; the full documentation is at
 https://pkg.go.dev/github.com/fsnotify/fsnotify
 
-**It's best to read the documentation at pkg.go.dev, as it's pinned to the last
-released version, whereas this README is for the last development version which
-may include additions/changes.**
-
 ---
 
 Platform support:
 
-| Adapter               | OS             | Status                                                       |
-| --------------------- | -------------- | ------------------------------------------------------------ |
+| Backend               | OS             | Status                                                       |
+| :-------------------- | :------------- | :----------------------------------------------------------- |
 | inotify               | Linux 2.6.32+  | Supported                                                    |
 | kqueue                | BSD, macOS     | Supported                                                    |
 | ReadDirectoryChangesW | Windows        | Supported                                                    |
 | FEN                   | illumos        | Supported in main branch                                     |
-| FSEvents              | macOS          | [Planned](https://github.com/fsnotify/fsnotify/issues/11)    |
-| fanotify              | Linux 5.9+     | [Maybe](https://github.com/fsnotify/fsnotify/issues/114)     |
+| FSEvents              | macOS          | [Not yet](https://github.com/fsnotify/fsnotify/issues/11)    |
+| fanotify              | Linux 5.9+     | [Not yet](https://github.com/fsnotify/fsnotify/issues/114)   |
 | USN Journals          | Windows        | [Maybe](https://github.com/fsnotify/fsnotify/issues/53)      |
-| Polling               | *All*          | [Maybe](https://github.com/fsnotify/fsnotify/issues/9)       |
+| Polling               | *All*          | [Not yet](https://github.com/fsnotify/fsnotify/issues/9)     |
 
 Linux, macOS, and illumos should include Android, iOS, and Solaris, but these
 are currently untested.

diff --git a/fsnotify.go b/fsnotify.go
index 5b6f74e0f08225c43626af38a16abf52d5424748..2b570fac371b7b8771ecc144d1dbe0c6c321c858 100644 (file)
--- a/fsnotify.go
+++ b/fsnotify.go
@@ -1,5 +1,12 @@
 // Package fsnotify provides a cross-platform interface for file system
 // notifications.
+//
+// Currently supported systems:
+//
+//    Linux 2.6.32+    via inotify
+//    BSD, macOS       via kqueue
+//    Windows          via ReadDirectoryChangesW
+//    illumos          via FEN
 package fsnotify
 
 import (
@@ -37,7 +44,7 @@ const (
        Chmod
 )
 
-// Common errors that can be reported by a watcher
+// Common errors that can be reported.
 var (
        ErrNonExistentWatch = errors.New("fsnotify: can't remove non-existent watcher")
        ErrEventOverflow    = errors.New("fsnotify: queue overflow")