Function: tags-next-file

tags-next-file is an autoloaded, interactive and byte-compiled function defined in etags.el.gz.

Signature

(tags-next-file &optional INITIALIZE NOVISIT)

Documentation

Select next file among files in current tags table.

A first argument of t (prefix arg, if interactive) initializes to the beginning of the list of files in the tags table. If the argument is neither nil nor t, it is evalled to initialize the list of files.

Non-nil second argument NOVISIT means use a temporary buffer
 to save time and avoid uninteresting warnings.

Value is nil if the file was already visited; if the file was newly read in, the value is the filename.

View in manual

Probably introduced at or before Emacs version 27.1.

Key Bindings

Aliases

next-file (obsolete since 27.1)

Source Code

;; Defined in /usr/src/emacs/lisp/progmodes/etags.el.gz
;;;###autoload
(defun tags-next-file (&optional initialize novisit)
  "Select next file among files in current tags table.

A first argument of t (prefix arg, if interactive) initializes to the
beginning of the list of files in the tags table.  If the argument is
neither nil nor t, it is evalled to initialize the list of files.

Non-nil second argument NOVISIT means use a temporary buffer
 to save time and avoid uninteresting warnings.

Value is nil if the file was already visited;
if the file was newly read in, the value is the filename."
  ;; Make the interactive arg t if there was any prefix arg.
  (interactive (list (if current-prefix-arg t)))
  (when initialize ;; Not the first run.
    (tags--compat-initialize initialize))
  (fileloop-next-file novisit)
  (switch-to-buffer (current-buffer)))