Variable: recentf-menu-filter

recentf-menu-filter is a customizable variable defined in recentf.el.gz.

Value

nil

Documentation

Function used to filter files displayed in the recentf menu.

A nil value means no filter. The following functions are predefined:

- recentf-sort-ascending
    Sort menu items in ascending order.
- recentf-sort-descending
    Sort menu items in descending order.
- recentf-sort-basenames-ascending
    Sort menu items by filenames sans directory in ascending order.
- recentf-sort-basenames-descending
    Sort menu items by filenames sans directory in descending order.
- recentf-sort-directories-ascending
    Sort menu items by directories in ascending order.
- recentf-sort-directories-descending
    Sort menu items by directories in descending order.
- recentf-show-basenames
    Show filenames sans directory in menu items.
- recentf-show-basenames-ascending
    Show filenames sans directory in ascending order.
- recentf-show-basenames-descending
    Show filenames sans directory in descending order.
- recentf-relative-filter
    Show filenames relative to default-directory.
- recentf-arrange-by-rule
    Show sub-menus following user defined rules.
- recentf-arrange-by-mode
    Show a sub-menu for each major mode.
- recentf-arrange-by-dir
    Show a sub-menu for each directory.
- recentf-filter-changer
    Manage a menu of filters.

The filter function is called with one argument, the list of menu elements used to build the menu and must return a new list of menu elements (see recentf-make-menu-element for menu element form).

Source Code

;; Defined in /usr/src/emacs/lisp/recentf.el.gz
(defcustom recentf-menu-filter nil
  "Function used to filter files displayed in the recentf menu.
A nil value means no filter.  The following functions are predefined:

- `recentf-sort-ascending'
    Sort menu items in ascending order.
- `recentf-sort-descending'
    Sort menu items in descending order.
- `recentf-sort-basenames-ascending'
    Sort menu items by filenames sans directory in ascending order.
- `recentf-sort-basenames-descending'
    Sort menu items by filenames sans directory in descending order.
- `recentf-sort-directories-ascending'
    Sort menu items by directories in ascending order.
- `recentf-sort-directories-descending'
    Sort menu items by directories in descending order.
- `recentf-show-basenames'
    Show filenames sans directory in menu items.
- `recentf-show-basenames-ascending'
    Show filenames sans directory in ascending order.
- `recentf-show-basenames-descending'
    Show filenames sans directory in descending order.
- `recentf-relative-filter'
    Show filenames relative to `default-directory'.
- `recentf-arrange-by-rule'
    Show sub-menus following user defined rules.
- `recentf-arrange-by-mode'
    Show a sub-menu for each major mode.
- `recentf-arrange-by-dir'
    Show a sub-menu for each directory.
- `recentf-filter-changer'
    Manage a menu of filters.

The filter function is called with one argument, the list of menu
elements used to build the menu and must return a new list of menu
elements (see `recentf-make-menu-element' for menu element form)."
  :group 'recentf
  :type '(radio (const nil)
                (function-item recentf-sort-ascending)
                (function-item recentf-sort-descending)
                (function-item recentf-sort-basenames-ascending)
                (function-item recentf-sort-basenames-descending)
                (function-item recentf-sort-directories-ascending)
                (function-item recentf-sort-directories-descending)
                (function-item recentf-show-basenames)
                (function-item recentf-show-basenames-ascending)
                (function-item recentf-show-basenames-descending)
                (function-item recentf-relative-filter)
                (function-item recentf-arrange-by-rule)
                (function-item recentf-arrange-by-mode)
                (function-item recentf-arrange-by-dir)
                (function-item recentf-filter-changer)
                function))