File: filesets.el.html

Define filesets, which can be opened or saved with the power of one or two mouse clicks only. A fileset is either a list of files, a file pattern, a base directory and a search pattern (for files), or an inclusion group (i.e. a base file including other files).

Usage:
1. Put (filesets-init) in your init file.
2. Type ;; M-x filesets-edit or choose "Edit Filesets" from the menu.
3. Save your customizations.

Caveat: Fileset names have to be unique.

Filesets.el adds a nifty filesets menu to your menubar. If you change your filesets on the fly, don't forget to select "Save Filesets" from the menu.

Pressing on the first item in the submenu will open all files at once. Define your own function, e.g. browse-url, for opening a fileset's files. Or define external viewers for opening files with other programs. See filesets-external-viewers.

BTW, if you close a fileset, files, which have been changed, will be silently saved. Change this behavior by setting filesets-save-buffer-function.

Defined variables (40)

filesets-be-docile-flagNon-nil means don’t complain if a file or a directory doesn’t exist.
filesets-browse-dir-functionA function or command used for browsing directories.
filesets-cache-fill-content-hookHook run when writing the contents of filesets’ cache file.
filesets-cache-hostnameFilesets’ cached system name.
filesets-cache-hostname-flagNon-nil means cache the hostname.
filesets-cache-save-often-flagNon-nil means save buffer on every change of the filesets menu.
filesets-cache-versionFilesets’ cached version number.
filesets-commandsCommands to run on filesets.
filesets-dataFileset definitions.
filesets-external-viewersAlist of file patterns and external viewers.
filesets-find-file-delayDelay before calling ‘find-file’.
filesets-has-changed-flagNon-nil means some fileset definition has changed.
filesets-ignore-next-set-defaultList of custom variables for which the next ‘set-default’ will be ignored.
filesets-ingroup-cacheA plist containing files and their ingroup data.
filesets-ingroup-filesList of files already processed when searching for included files.
filesets-ingroup-patternsInclusion group definitions.
filesets-max-entry-lengthTruncate names of split submenus to this length.
filesets-max-submenu-lengthMaximum length of submenus.
filesets-menu-beforeThe name of a menu before which this menu should be added.
filesets-menu-cacheThe whole filesets menu.
filesets-menu-cache-contentsStuff we want to save in ‘filesets-menu-cache-file’.
filesets-menu-cache-fileFile to be used for saving the filesets menu between sessions.
filesets-menu-ensure-use-cachedMake sure (X)Emacs uses filesets’ cache.
filesets-menu-in-menuUse that instead of ‘current-menubar’ as the menu to change.
filesets-menu-nameFilesets’ menu name.
filesets-menu-pathThe menu under which the filesets menu should be inserted.
filesets-menu-shortcuts-flagNon-nil means to prepend menus with hopefully unique shortcuts.
filesets-menu-shortcuts-markerString for marking menu shortcuts.
filesets-menu-use-cached-flagNon-nil means use cached data.
filesets-open-file-functionThe function used for opening files.
filesets-output-buffer-flagNon-nil means the current buffer is an output buffer created by filesets.
filesets-query-user-limitQuery the user before opening a fileset with that many files.
filesets-save-buffer-functionThe function used to save a buffer.
filesets-sort-case-sensitive-flagNon-nil means sorting of the filesets menu is case sensitive.
filesets-sort-menu-flagNon-nil means sort the filesets menu alphabetically.
filesets-submenusAn association list with filesets menu data.
filesets-tree-max-levelMaximum scan depth for directory trees.
filesets-update-cache-file-flagNon-nil means the cache needs updating.
filesets-updated-buffersA list of buffers with updated menu bars.
filesets-verbosityAn integer defining the level of verbosity.

Defined functions (115)

filesets-add-buffer(&optional NAME BUFFER)
filesets-alist-get(ALIST KEY &optional DEFAULT CARP)
filesets-browse-dir(DIR)
filesets-browser-name()
filesets-build-dir-submenu(ENTRY LOOKUP-NAME DIR PATT)
filesets-build-dir-submenu-now(LEVEL DEPTH ENTRY LOOKUP-NAME DIR PATT FD &optional REBUILD-FLAG)
filesets-build-ingroup-submenu(LOOKUP-NAME MASTER)
filesets-build-menu()
filesets-build-menu-maybe()
filesets-build-menu-now(FROM-SCRATCH-FLAG)
filesets-build-submenu(COUNT LOOKUP-NAME ENTRY)
filesets-close(&optional MODE NAME LOOKUP-NAME)
filesets-cmd-get-args(CMD-NAME)
filesets-cmd-get-def(CMD-NAME)
filesets-cmd-get-fn(CMD-NAME)
filesets-cmd-isearch-getargs()
filesets-cmd-query-replace-getargs()
filesets-cmd-query-replace-regexp-getargs()
filesets-cmd-shell-command(TXT)
filesets-cmd-shell-command-getargs()
filesets-cmd-show-result(CMD OUTPUT)
filesets-conditional-sort(LST &optional ACCESS-FN)
filesets-convert-path-list(STRING)
filesets-convert-patterns(NAME)
filesets-customize()
filesets-data-get(ENTRY KEY &optional DEFAULT CARP)
filesets-data-get-data(ENTRY)
filesets-data-get-name(ENTRY)
filesets-data-set(ENTRY KEY VALUE)
filesets-data-set-default(SYM VAL)
filesets-directory-files(DIR &optional PATTERN WHAT FULL-FLAG MATCH-DIRS-FLAG)
filesets-edit()
filesets-entry-get-dormant-flag(ENTRY)
filesets-entry-get-file(ENTRY)
filesets-entry-get-files(ENTRY)
filesets-entry-get-filter-dirs-flag(ENTRY)
filesets-entry-get-master(ENTRY)
filesets-entry-get-open-fn(FILESET-NAME &optional FILESET-ENTRY)
filesets-entry-get-pattern(ENTRY)
filesets-entry-get-pattern--dir(LIST)
filesets-entry-get-pattern--pattern(LIST)
filesets-entry-get-save-fn(FILESET-NAME &optional FILESET-ENTRY)
filesets-entry-get-tree(ENTRY)
filesets-entry-get-tree-max-level(ENTRY)
filesets-entry-get-verbosity(ENTRY)
filesets-entry-mode(ENTRY)
filesets-entry-set-files(ENTRY DATA &optional ANYWAYS)
filesets-error(CLASS &rest ARGS)
filesets-eviewer-constraint-p(ENTRY)
filesets-eviewer-get-props(ENTRY)
filesets-file-close(SAVE-FUNCTION BUFFER)
filesets-file-open(OPEN-FUNCTION FILE-NAME &optional FILESET-NAME)
filesets-files-equalp(A B)
filesets-files-in-same-directory-p(A B)
filesets-files-under(LEVEL DEPTH ENTRY DIR PATT &optional RELATIVEP)
filesets-filetype-get-prop(PROPERTY FILENAME &optional ENTRY)
filesets-filetype-property(FILENAME EVENT &optional ENTRY)
filesets-filter-dir-names(LST &optional NEGATIVE)
filesets-filter-list(LST COND-FN)
filesets-find-file(FILE)
filesets-find-file-using()
filesets-find-or-display-file(&optional FILE VIEWER)
filesets-get-cmd-menu()
filesets-get-external-viewer(FILE)
filesets-get-external-viewer-by-name(NAME)
filesets-get-filelist(ENTRY &optional MODE EVENT)
filesets-get-fileset-from-name(NAME &optional MODE)
filesets-get-fileset-name(SOMETHING)
filesets-get-menu-epilog(SOMETHING &optional MODE LOOKUP-NAME REBUILD-FLAG)
filesets-get-quoted-selection()
filesets-get-selection()
filesets-get-shortcut(N)
filesets-goto-homepage()
filesets-info()
filesets-ingroup-cache-get(MASTER)
filesets-ingroup-cache-put(MASTER FILE)
filesets-ingroup-collect(FS REMDUPL-FLAG MASTER)
filesets-ingroup-collect-build-menu(FS FLIST &optional OTHER-COUNT)
filesets-ingroup-collect-files(FS &optional REMDUPL-FLAG MASTER DEPTH)
filesets-ingroup-collect-finder(PATT CASE-SENSITIVEP)
filesets-ingroup-get-data(MASTER POS &optional FUN)
filesets-ingroup-get-pattern(MASTER)
filesets-ingroup-get-remdupl-p(MASTER)
filesets-init()
filesets-member(ITEM LIST [KEYWORD VALUE]...)
filesets-menu-cache-file-load()
filesets-menu-cache-file-save()
filesets-menu-cache-file-save-maybe(&optional SIMPLY-DO-IT)
filesets-message(LEVEL &rest ARGS)
filesets-open(&optional MODE NAME LOOKUP-NAME)
filesets-ormap(FSOM-PRED LST)
filesets-quote(TXT)
filesets-rebuild-this-submenu(FILESET)
filesets-remake-shortcut(COUNT SUBMENU)
filesets-remove-buffer(&optional NAME BUFFER)
filesets-remove-from-ubl(&optional BUFFER)
filesets-reset-filename-on-change()
filesets-reset-fileset(&optional FILESET NO-CACHE)
filesets-run-cmd(&optional CMD-NAME FILESET MODE)
filesets-run-cmd--repl-fn(ARG &optional FORMAT-FN)
filesets-save-config()
filesets-select-command(CMD-LIST)
filesets-set-config(FILESET VAR VAL)
filesets-set-default(SYM VAL &optional INIT-FLAG)
filesets-set-default!(SYM VAL)
filesets-set-default+(SYM VAL)
filesets-some(PREDICATE SEQ...)
filesets-spawn-external-viewer(FILE &optional EV-ENTRY)
filesets-sublist(SEQUENCE START &optional END)
filesets-update(CACHED-VERSION)
filesets-update-cleanup()
filesets-which-command(CMD)
filesets-which-command-p(CMD)
filesets-which-file(MASTER FILENAME &optional PATH-LIST)
filesets-wrap-submenu(SUBMENU-BODY)

Defined faces (0)