Provided by: xfm_1.5.4-1_i386 bug

NAME

       xfm_mailcap - mailcap information for usage within xfm or xfmmailcap

DESCRIPTION

       To  determine  what  command to use to open a file with a specific mime
       type, xfm(1) uses files in a format similar to the mailcap format.

       The extensions are special actions to open directories or files to load
       into the application window and to include other mailcap files, so that
       the   default   mailcap   databases   in   ~/.mailcap,    /etc/mailcap,
       /usr/share/etc/mailcap and /usr/local/etc/mailcap can be included.

       This  man  page describes which fields are used and the extensions. For
       general information of the syntax of these files  read  the  man  pages
       mailcap(5) and update-mime(8).

       While  this  files are supposed to be read by xfm(1), there also is the
       program xfmmailcap(1) to ease debugging.

GENERAL FORMAT

       There is one entry per line.  Empty lines and  lines  starting  with  a
       hash  (#)  are  ignored.   Each  line  consists  of  parts separated by
       semicolons (;).  The first part is the mime part or the token  include.
       The  second  part  is the view option. This is followed by an arbitrary
       number of option names, followed by a value after a equal sign, if they
       have a value.

INCLUDES

       Lines  with  a mime-type include or !include are not treated as mailcap
       specifiers, but cause the filename described by the second argument  to
       be  read  at  this place. I recommend placing the following line at the
       end of every $HOME/.xfm/xfm_mailcap file:

         include; /etc/X11/xfm/mailcap

OPTIONS USED BY XFM

       test   The value of this option (after unescaping)  is  executed  using
              system(3).  If it fails, the content of the line is not used for
              anything but  increasing  the  amount  of  output.   Some  tests
              weather  a  DISPLAY environment variable are set are omitted and
              considered always true.

       nametemplate
              If this option has a value, the filename has to match it when  a
              action  is  executed.   Otherwise  it  is  replaced by a symlink
              matching it. It has to contain exactly one unescaped  occurrence
              of  %s,  which  is  used as wild card for any positive number of
              characters.

       edit   This is the preferred action to open a file.  Unless it  is  one
              of  the  special  actions  explained  below,  it  has to contain
              exactly one unescaped occurance of %s, which is replaced by  the
              filename  to  open,  or the filename of a symlink to the file to
              open in the case the filename might be  dangerous  or  does  not
              match the nametemplate of this line.

       needsterminal
              If  this  option,  which  normally  has  no value, is there, the
              actions specified in this line are executed  in  an  X  terminal
              emulator.

SPECIAL ACTIONS

       If the action with the highest priority is one the special strings OPEN
       or LOAD, no shell is spawned and  no  command  executed.   Instead  the
       current  file window is changed to the selected directory (OPEN) or the
       file is supposed to be  in  the  xfm(5)  format  and  loaded  into  the
       application window(LOAD).

FILES

       $HOME/.xfm/xfm_mailcap
              Unless  xfm(1)  is  told  to  look  at  a  different place via X
              resource Xfm.mailcapFile, this is the first place xfm looks  for
              a  file  with  the describes format.  xfmmailcap(1) always looks
              here first.

       /etc/X11/xfm/xfm_mailcap
              If the first file does not exists, xfm(1) (unless it gets told a
              different  place  via  the X resource Xfm.systemwideMailcapFile)
              and xfmmailcap(1) look for this file.  It  is  recommended  that
              the  file  in  the  home directory includes this file to get the
              system wide defaults.

SEE ALSO

       xfm(1), xfmmailcap(1), mailcap(5), update-mime(8).