GNU Info

(dired-x)Omitting Variables

---

Next: Omitting Examples Up: Omitting Files in Dired

---

Enter node , (file) or (file)node

Omitting Variables
==================

   The following variables can be used to customize omitting.

`dired-omit-files-p'
     Default: `nil'

     If non-`nil', "uninteresting" files are not listed.  Uninteresting
     files are those whose files whose names match regexp
     `dired-omit-files', plus those ending with extensions in
     `dired-omit-extensions'.  `M-o' (`dired-omit-toggle') toggles its
     value, which is buffer-local.  Put

          (setq dired-omit-files-p t)

     inside your `dired-mode-hook' to have omitting initially turned on
     in _every_ Dired buffer (Note: Installation).  You can then use
     `M-o' to unomit in that buffer.

     To enable omitting automatically only in certain directories one
     can use Dired Local Variables and put

          Local Variables:
          dired-omit-files-p: t
          End:

     into a file `.dired' (the default value of
     `dired-local-variables-file') in that directory (Note: Local
     Variables).

    `dired-omit-here-always'
          This is an interactive function that creates a local
          variables file exactly like the example above (if it does not
          already exist) in the file `dired-local-variables-file' in
          the current directory and then refreshes the directory
          listing (Note: Local Variables).

`dired-omit-files'
     Default: `"^#\\|\\.$"'

     Files whose names match this buffer-local regexp will not be
     displayed.  This only has effect when `dired-omit-files-p''s value
     is `t'.

     The default value omits the special directories `.' and `..'  and
     autosave files (plus other files ending in `.') (Note: Omitting
     Examples).

`dired-omit-extensions'
     Default: The elements of `completion-ignored-extensions',
     `dired-latex-unclean-extensions', `dired-bibtex-unclean-extensions'
     and `dired-texinfo-unclean-extensions'.

     If non-`nil', a list of extensions (strings) to omit from Dired
     listings.  Its format is the same as that of
     `completion-ignored-extensions'.

`dired-omit-localp'
     Default:  `no-dir'

     The LOCALP argument `dired-omit-expunge' passes to
     `dired-get-filename'.  If it is `no-dir', omitting is much faster,
     but you can only match against the non-directory part of the file
     name.  Set it to `nil' if you need to match the whole file name or
     `t' to match the file name relative to the buffer's top-level
     directory.

`dired-omit-marker-char'
     Default: `C-o'

     Temporary marker used by Dired to implement omitting.  Should
     never be used as marker by the user or other packages.  There is
     one exception to this rule: by adding

          (setq dired-mark-keys "\C-o")
          ;; i.e., the value of dired-omit-marker-char
          ;; (which is not defined yet)

     to your `~/.emacs', you can bind the `C-o' key to insert a `C-o'
     marker, thus causing these files to be omitted in addition to the
     usually omitted files.  Unfortunately the files you omitted
     manually this way will show up again after reverting the buffer,
     unlike the others.