(buffer-match-p): Replace `&optional` with `&rest` (bug#65797)

* lisp/subr.el (buffer-match-p--past-warnings): New var.
(buffer-match-p): Use it.  Replace `&optional arg` with `&rest args`.
(match-buffers): Replace `&optional arg` with `&rest args`.

* lisp/window.el (display-buffer-alist): Fix out of date docstring.

* doc/lispref/buffers.texi (Buffer List): Document new calling convention.
1 job for master in 10 minutes and 39 seconds (queued for 4 minutes and 55 seconds)
Status Job ID Name Coverage
  Normal
failed #75763
test-lisp-inotify

00:10:39

 
Name Stage Failure
failed
test-lisp-inotify Normal
$ find ${test_name} ! \( -name "*.log" -o -name ${EMACS_TEST_JUNIT_REPORT} \) -type f -delete
find: test-lisp-inotify-c94b6397: No such file or directory
Uploading artifacts...
WARNING: test-lisp-inotify-c94b6397/: no matching files
ERROR: No files to upload
Uploading artifacts...
WARNING: test-lisp-inotify-c94b6397/junit-test-report.xml: no matching files
ERROR: No files to upload
ERROR: Job failed: exit code 1