Update highlighting, and documentation.

1 files changed, 8 insertions, 2 deletions

diff --git a/doc/list.md b/doc/list.md
index 2fa543536..fa07bd973 100644..100755
--- a/doc/list.md
+++ b/doc/list.md
@@ -12,6 +12,12 @@ This command will print to stdout all the versions of packages that are
 either installed or available in the registry, with their tags and whether
 or not they're active and/or stable.
 
-To filter a single package or state, pipe this command through grep.
+To filter a single package or state, you can provide words to filter on
+and highlight (if appropriate).  For instance, to see all the stable
+packages, you could do this:
 
-    npm ls | grep @stable
+    npm ls @stable
+
+Strings are matched using the JavaScript "split" function, so regular
+expression strings are ok.  However, the highlighting is a simple
+split/join, so regexps probably won't get the funky colors.