#
# Here is the structure and options of Ion configuration file commented.
#

# Include another file
include "file"

# Double click delay (default: 250ms)
dblclick_delay msec

# Timeout before automatically leaving resize mode (default: 1.5s)
resize_delay msec

# Opaque resize? (default: no)
opaque_resize TRUE/FALSE


# Screen <screennum> specific settings
screen <screennum> {
	# Font used in terminal emulators (xterm, etc.)
	# CF_WIDTH/HEIGHT_UNIT that grow/shrink use are taken from this.
	term_font "font"

	# Font
	font "fontname"

	# Tab font
	tab_font "fontname"

	# Frame border
	#  tl - top and left border width
	#  br - bottom and right border width
	#  ipad - contents padding
	frame_border tl, br, ipad

	# Tab border
	tab_border tl, br, ipad

	# Input (line-editor) border
	input_border tl, br, ipad

	# Frame and tab spacing
	spacing pixels

	# Place bar inside or outside frame border?
	bar_inside_frame TRUE/FALSE?

	# Active frame, unselected tab colors
	#  tl - top and left border
	#  br - bottom and right border
	#  bg - background
	#  fg - foreground (text)
	# The colors are normal X color specifications. See the
	# manual page for XParserColor(3x) for more.
	act_tab_colors "tl", "br", "bg", "fg"

	# Active frame, selected tab colors
	act_tab_sel_colors "tl", "br", "bg", "fg"

	# Inactive frame, unselected tab colors
	tab_colors "tl", "br", "bg", "fg"

	# Inactive frame, selected tab clors
	tab_sel_colors "tl", "br", "bg", "fg"

	# Frame colors
	frame_colors "tl", "br", "bg", "fg"

	# Workspace background
	background_color "bg"

	# Input (line-editor) colors
	input_colors "tl", "br", "bg", "fg"

	# Selected text colors
	selection_colors "bg", "fg"
}


# Settings for window "class.instance"  (e.g. XTerm.xterm)
winprop "class.instance" {
	# Maximum size (overrides size hints)
	max_size w, h

	# Aspect ratio (overrides size hints)
	aspect w, h

	# Kludge to get acrobat reader work
	acrobatic

	# Switch to newly created client? (default: yes)
	switchto TRUE/FALSE

	# Stubborn window placement? Used with CF_PLACEMENT_GEOM
	# to ignore client-supplied coordinates of badly behaving
	# windows. (default: no)
	stubborn TRUE/FALSE
	
	# current - force window become a transient for active client
	# off - force window not be interpreted as a transient
	transient_mode normal|current|off
}


# Key and pointer bindings
# Key names are passed to XStringToKeysym and are those defined in
# /whereever_x_is/include/keysymdef.h without the XK_ -prefix.
bindings {
	# Set default modifier
	set_mod "modifier"

	# Key press
	kpress "[modifiers+]key", "function" [, args]

	# Key press, wait for pointer release
	kpress_waitrel "[modifiers+]key", "function" [, args]

	# Pointer button press
	mpress "[modifiers+]ButtonX", "function" [, args]

	# Pointer drag
	mdrag "[modifiers+]ButtonX", "function" [, args]

	# Click
	mclick "[modifiers+]ButtonX", "function" [, args]

	# Double click
	mdblclick "[modifiers+]ButtonX", "function" [, args]

	submap "[modifiers+]key" {
		# ...
	}
}


# Line-editor bindings
edln_bindings {
	# ...
}


# Tab bindings (keys not useful)
tab_bindings {
	# ...
}


# Resize-mode bindings
moveres_bindings {
	# ...
}
