bug#977: 23.0.60; doc string of `filesets-data'

bug#977: 23.0.60; doc string of `filesets-data'

[Drew Adams]

This part of the doc string is incorrect:
 
  :pattern DIR PATTERN ... PATTERN is a regular expression
  comprising path and file pattern -- e.g. 'PATH/^REGEXP$'.
  Note the `^' at the beginning of the file name pattern.
 
I think this text reflects an older version of filesets.el, before the
change in :pattern format. See doc string of
`filesets-update-pre010505' for an explanation of the change in
format.
 
IIUC, DIR is a pattern that matches a directory and PATTERN is a
pattern that matches files (and subdirs) in that directory.  The old
format combinded DIR and PATTERN in one regexp, but they are now
separated, so the text about PATTERN "comprising path and file pattern
-- e.g. 'PATH/^REGEXP$'" is simply wrong.  (Besides which, we don't
use "path" this way in the Emacs doc - we use "directory" instead.)
 

In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
 of 2008-09-03 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include
-fno-crossjumping'
 

bug#977: 23.0.60; doc string of `filesets-data'

[Chong Yidong]

Hi Thomas, here's a documentation bug report for filesets.el:

> This part of the doc string is incorrect:
> 
>   :pattern DIR PATTERN ... PATTERN is a regular expression
>   comprising path and file pattern -- e.g. 'PATH/^REGEXP$'.
>   Note the `^' at the beginning of the file name pattern.
> 
> I think this text reflects an older version of filesets.el, before the
> change in :pattern format. See doc string of
> `filesets-update-pre010505' for an explanation of the change in
> format.
> 
> IIUC, DIR is a pattern that matches a directory and PATTERN is a
> pattern that matches files (and subdirs) in that directory.  The old
> format combinded DIR and PATTERN in one regexp, but they are now
> separated, so the text about PATTERN "comprising path and file pattern
> -- e.g. 'PATH/^REGEXP$'" is simply wrong.  (Besides which, we don't
> use "path" this way in the Emacs doc - we use "directory" instead.)

What's the difference between :tree and :pattern here?

bug#977: 23.0.60; doc string of `filesets-data'

[Tom Link]

> What's the difference between :tree and :pattern here?
>   
IIRC pattern isn't recursive.