Note (without example) about Stream in README

diff --git a/README.md b/README.md
index 58cbf173cd1d9f40806644b7920e0779f0c76273..6675de3c9d3d68f908a25d036db3326216821c9d 100644 (file)
--- a/README.md
+++ b/README.md
@@ -97,7 +97,13 @@ for i := 0; i < n; i++ {
 }
 ```
 
-For more examples, see the `_test.go` files.
+### Vorbis (streams and files)
+
+To decode a .opus file (or .ogg with Opus data), or to decode a "Opus stream"
+(which is a Ogg stream with Opus data), use the `Stream` interface. It wraps an
+io.Reader providing the raw stream bytes and returns the decoded Opus data.
+
+See https://godoc.org/github.com/hraban/opus#Stream for further info.
 
 ### API Docs
 
@@ -107,6 +113,8 @@ https://godoc.org/github.com/hraban/opus
 Full libopus C API reference:
 https://www.opus-codec.org/docs/opus_api-1.1.3/
 
+For more examples, see the `_test.go` files.
+
 ## Build & installation
 
 This package requires libopus and libopusfile development packages to be