Update docs to explain use of -g and --files to search for paths. (#285)

Update docs to explain use of -g and --files to search for paths.

Fixes #284

README.md

@@ -268,6 +268,12 @@ Or exclude files matching a particular glob:
 $ rg foo -g '!*.min.js'
 ```
 
+Search and return paths matching a particular glob (i.e., `-g` flag in ag/ack):
+
+```
+$ rg -g 'doc*' --files
+```
+
 Search only HTML and CSS files:
 
 ```

doc/rg.1

@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 1.18
+.\" Automatically generated by Pandoc 1.19.1
 .\"
-.TH "rg" "1"
+.TH "" "" "" "" ""
 .hy
 .SH NAME
 .PP
@@ -69,6 +69,14 @@ Multiple glob flags may be used.
 Globbing rules match .gitignore globs.
 Precede a glob with a \[aq]!\[aq] to exclude it.
 .RS
+.PP
+Values given to \-g must be quoted or your shell will expand them and
+result in unexpected behavior.
+.PP
+Combine with the \-\-files flag to return matched filenames (i.e., to
+replicate ack/ag\[aq]s \-g flag).
+.PP
+For example: rg \-g \[aq]<glob>\[aq] \-\-files
 .RE
 .TP
 .B \-h, \-\-help
@@ -202,6 +210,10 @@ counted as part of the pattern.
 .B \-\-files
 Print each file that would be searched (but don\[aq]t search).
 .RS
+.PP
+Combine with the \-g flag to return matched paths, for example:
+.PP
+rg \-g \[aq]<glob>\[aq] \-\-files
 .RE
 .TP
 .B \-l, \-\-files\-with\-matches

doc/rg.1.md

@@ -52,6 +52,14 @@ Project home page: https://github.com/BurntSushi/ripgrep
   overrides any other ignore logic. Multiple glob flags may be used. Globbing
   rules match .gitignore globs. Precede a glob with a '!' to exclude it.
 
+    Values given to -g must be quoted or your shell will expand them and result
+    in unexpected behavior.
+
+    Combine with the --files flag to return matched filenames
+    (i.e., to replicate ack/ag's -g flag).
+
+    For example: rg -g '\<glob\>' --files
+
 -h, --help
 : Show this usage message.
 
@@ -136,6 +144,10 @@ Project home page: https://github.com/BurntSushi/ripgrep
 --files
 : Print each file that would be searched (but don't search).
 
+    Combine with the -g flag to return matched paths, for example:
+
+    rg -g '\<glob\>' --files
+
 -l, --files-with-matches
 : Only show path of each file with matches.