#   XD configuration file example

#   Default location used by xd: $HOME/.xdrc

#   If you don't have a file  $HOME/.xdrc and did not specify a configuration
#   file using the --config-file command line option then program defined
#   defaults (shown here as well) will be used.

#   By default directives and values are interpreted case sensitively

#   When directives are provided repeatedly the last directive will be used
#   (except for ignore, which are all interpreted)

#   The commented-out examples show the default specifications or (if 
#   indicated so by extra comment) show the specification format


# The add-root directive determines when to perform an additional search
# starting from the root (/) directory:
#       always      - an additional search is always performed.
#       if-empty    - an additional search is performed if the initial search
#                     did not yield any directory.
#       never       - no additional search is performed.
#add-root if-empty

# The 'all' directive suppresses the 'ignore' directives. 
#all    # Not used by default, usually specified as command-line option


# The block-size directive specifies the max. number of directory alternatives 
# that are displayed in a block. 
#block-size 10  # by default no limit, the 10 used here is an example

# The directories directive defines which directives are shown:
#   all     - show all alternatives, including symbolic links (symlinks)
#   unique  - do not show symlinks to directories
#directories all

# The generalized-search (GDS) on is specified bf(xd) directory separators are
# no longer required, and xd finds all posible alternatives resulting from
# all possible sequential combinations of the initial search command.
# Directory separators are honored when specified, even when
# generalized-search is specified. However, they are *required* if
# generalized-search is not specified or (same thing) if 'traditional'
# is specified.
#generalized-search

# The homedir-char directive defines the initial specification char used to
# specify the user's home-dir
#homedir-char  .

# Specify the name of the history file if a history of previously made
# choices most be kept. If only the 'history' directive is specified the
# history file is $HOME/.xd.his
# The next history directives are only interpreted if the 'history'
# directive is specified
#history 

# The lifetime of the entries in the history file. 
# using D, W, M and Y to represent resp. days, weeks, months, or years.
#history-lifetime 1M

# The maximum number of entries the history file may contain.
#history-maxsize 50 # by default no limit, the 50 used here is an example

# Previously found directory alternatives are displayed either
# at the top of the list or at the bottom of the list. If omitted then the
# elements in the history are intermixed with new alternatives.
#history-position top # by default not used, here  using 'top' as an example

# A blank line is written between the items in the history and new
# alternatives (not previously selected). 
# This option is only interpreted when the previous option is also specified
#history-separate   # by default not used

#   The icase option is used to specify case-insensitive pattern matching. By
#   default case sensitive pattern matching is used.
#icase  # by default not used

#   Multiple ignore specifications may be specified. Directories matching the
#   specification will not show up in the list of alternatives. Specifications
#   may end in a *
#ignore /usr/lib/bonobo*    # by default not used: the specification is 
                            # provided as an example

# The ignore directives (multiple ignore directives are all interpreted)
# defines directories that should not appear in alternative
# lists. Specifications may end in a final *, indicating that all
# directories matching the provided pattern will be ignored.
# There is no default. Some examples:
#     ignore /usr/lib/bonobo/
#     ignore /usr/lib/bonobo-activation/
# or, using wildcards:
#     ignore /usr/lib/bonobo*

# Xd itself issues the tt(cd) command for the selected directory to the shell,
# and enters other (non alternative-selecting characters) into the shell's
# input.
#input      # by default not used

#   The start-at directive defines the origin of the search:
#       home    - start the search from the user's home dir.
#       root    - start the search from the root (/) directory.
#start-at home

# Xd does not use GDS but uses its traditional mode
#traditional # by default not used