Re: collect-string

[Stephen J. Turnbull]

Tak Ota writes:

 > > ! When prefix argument is provided without a number (`C-u' alone as
 > > ! prefix) the matching strings are collected into the `*Occur*'
 > > ! buffer.  When COLLECT is zero the entire matched strings are
 > > ! collected otherwise COLLECTth pair of parenthesized match in the
 > > ! REGEXP is collected."

I don't think this describes the behavior of the prefix argument
correctly (you will be prompted for a number, IIUC).  What happens
when the prefix argument is a number?

 > > ! (defun multi-occur-in-matching-buffers (bufregexp regexp &optional 
 > > allbufs collect)
 > >     "Show all lines matching REGEXP in buffers specified by BUFREGEXP.
 > >   Normally BUFREGEXP matches against each buffer's visited file name,
 > >   but if you specify a prefix argument, it matches against the buffer name.

The COLLECT argument is undocumented.

Aside to the maintainers: the ALLBUFS argument could use further
clarification, but that's not Tak's responsibility.