ASDatabaseEntry(1) AfterStep X11 window manager ASDatabaseEntry(1)

NAME

ASDatabaseEntry - to be used in entry of AfterStep database

CONFIGURATION OPTIONS

AllowCover

Specifies that other windows should be allowed to cover the
app window. Turns off AvoidCover . This is the default
setting.


AvoidCover

Specifies that other windows should not be allowed to cover
the app window. Prevents other windows from moving in front of
(or behind) the app window. If SmartPlacement is specified in
the feel file, windows will not be allowed to automatically
place themselves over the app window, if possible. AllowCover
turns off AvoidCover . The default is AllowCover .


BorderWidth width

Specifying this in conjunction with NoHandles , sets the
border width of a window to be width . A width of0causes no
border. This option has no affect if not used with NoHandles .
The default is1implicitly for all windows.


Button number

Specifying a number to each use of Button will cause that
buttons number to be displayed in the title bar. Number should
be the same as used in TitleButtons setting. The default is to
display all buttons defined in the look.name file if the
following conditions are met: there is a valid bitmap or
pixmap specified for the button in the look.name file; nd the
button has not been forced not to display by the use of Motif
WM hints specified by application.


CirculateHit

Enables window to be switched to using ChangeWindowUp,
ChangeWindowDown or Warp (also called alt-tabbing) functions.
This is the default implicitly for all windows.


CirculateSkip

Causes windows to be skipped over when the ChangeWindowUp,
ChangeWindowDown or Warp (also called alt-tabbing) functions
are invoked. This is disabled by default implicitly for all
windows.


DefaultGeometry WIDTHxHEIGHT+X+Y

This will force AfterStep to replace parts of window initial
placement with predefined values. For example :

Style "*mozilla*" DefaultGeometry 1024x500

will force mozilla windows (or any windows that have "mozilla"
in its name ) to have initial size 1024x500.

Note that in case of mozilla its useful to define several
Styles so that you will get different geometries for different
dialog boxes, such as search/download/ etc


Focus

This will set the window to accept input focus. The is the
default for all windows.


FocusOnMap

Client window will be focused when it is mapped even if it is
not directly under mouse pointer.


FocusStyle [ style ]

Specifies a MyStyle to be used for this window when it has the
keyboard focus. If style is unspecified, the default focus
style will be used instead (see FWindowStyle , below).


Frame "frame_name"

Enables "frame_name" to be used for decoration of this window.


Fullscreen

Makes window Fullscreen on startup.


HandleWidth width

Specifies the width of the resize handles on the The default
width is8pixels.


Handles

Specifies that the app window will display the "low bar"
decoration. This is the default for all windows.


HonorConfig

Forces AfterStep to honor a client's request to reposition
itself after its window has been mapped. This is a dangerous
behavior as clients do not have a reliable way of determining
the best position for themselves. Window positioning should be
left to AfterStep as it knows better. Opposite of
IgnoreConfig.

See Also: IgnoreConfig.


HonorExtWMHints

Forces AfterStep to use extended window management hints that
the client sets on its windows. These generally include window
type (dialog, desktop, menu, etc), window state (minimized,
maximized, shaded, etc.), desktop, icon and additional data.
Note that these window-type hints cause AfterStep to apply one
of its policies, which may result in missing decorations, a
non-default layer, and other potential irregularities. The
opposite is NoExtWMHints.

See Also: NoExtWMHints.


HonorGnomeHints

Forces AfterStep to use the desktop, layer, and other hints
data that a client sets on its window using the old, outdated
GNOME window management hints. The opposite is NoGnomeHints.

See Also: NoGnomeHints.


HonorGroupHints

AfterStep will utilize a group hint set on the client's
window. This will make AfterStep apply group management
policies to all windows of the client. For example: when one
window in the group is moved to a different desktop, all other
windows will follow. Group members will usually be stacked
together and utilize the layer of the member with the highest
layer within the given group. Transient windows belonging to
one of the members will overlay all of the members. The
opposite is NoGroupHints.

See Also: NoGroupHints.


HonorKDEHints

AfterStep will honor KDE specific hints set on the client's
window. This is mainly used for status bar-type applications.
The opposite is NoKDEHints.

See Also: NoKDEHints.


HonorMotifHints

AfterStep will honor Motif specific hints set on the client's
window. This includes any decorations that need to be drawn
around it and any functions (minimize/maximize/re-size/move)
that it supports. The opposite is NoMotifHints.

See Also: NoMotifHints.


HonorPPosition

Forces AfterStep to use PPosition hint for this window.
PPosition hint normally means that application has determined
its position due to some of its own configuration settings,
and position has not been explicitly requested on the command
line. This setting overrides NoPPosition setting in feel file.


HonorRestack

FIXME: add proper description here.


HonorTransientHints

Will force AfterStep to use transient hint, effectively
attaching window to its parent( placing it on the same layer ,
etc. )


HonorXResources

Forces AfterStep to respect XResources database when it comes
to window placement.


HorizontalTitle

Causes the window titlebar to be placed horizontally on top of
the window. This is the implicit default for all windows.


Icon filename

Specifies the [filename] to use when iconified, overriding any
icon the app itself might provide. NoIcon turns this off. The
default is to use the app's supplied icon or the icon
specified with the WM_NAME of "Unknown" or "*".


IconTitle

Specifies that a title should be displayed under an iconified
app. The colors used are the ForeColor and BackColor of the
ButtonTitleFocus in the look.name file. Note: less space is
left for the app's icon, so it will be resized acordingly.
Only a portion of the icon title will be displayed until the
icon gains focus, and then the title "box" will expand to
reveal the window's entire name.


IgnoreConfig

AfterStep will ignore a client's attempts to reposition its
window after it has been mapped on the screen. Opposite of
HonorConfig.

See Also: HonorConfig.


IgnoreRestack

FIXME: add proper description here.


Layer layer

Specifies what layer this window should be in. layer may be
any integer (positive, negative, or zero). Windows are grouped
according to their layer, and may not be moved out of their
layer. Windows in higher layers will be above windows in lower
layers. By default, windows are placed in layer 0. StaysOnBack
corresponds toLayer -1, and StaysOnTop corresponds to Layer 1
.


LongLiving

A window will stay on the screen long enough to allow
application of different placement policies, such as
AvoidCover. Opposite of ShortLiving.

See Also: ShortLiving.


NoButton number

Specifying a number to each use of NoButton will cause that
buttons be hidden from the title bar. Number should be the
same as used in TitleButtons setting. The default is to
display all buttons defined in the look.name file if the
following conditions are met: there is a valid bitmap or
pixmap specified for the button in the look.name file; and the
button has not been forced not to display by the use of Motif
WM hints specified by application.


NoExtWMHints

AfterStep will not use extended window management hints that
the client sets on its windows. Opposite of HonorExtWMHints.

See Also: HonorExtWMHints.


NoFocus

This will set the window to refuse any input focus. Focus will
turn this setting off. This is off by default.


NoFocusOnMap

AfterStep will not yield a focus to the new window being
mapped. This prevents things like passwords typed into
popped-up IM windows. Opposite of FocusOnMap.

See Also: FocusOnMap.


NoFrame

Disables frame decorations for this window.


NoFullscreen

Prevents windows from starting up as Fullscreen.


NoGnomeHints

Causes AfterStep to disregard layer properties and several
obsolete properties for a window. Opposite of HonorGnomeHints.

See Also: HonorGnomeHints.


NoGroupHints

AfterStep will not utilize a group hint set on the client's
window. Opposite of HonorGroupHints.

See Also: HonorGroupHints.


NoHandles

Specifies that the app window will not display the "low bar"
decoration. This also removes the ability to resize windows
with the resize handles on the "low bar" ends. The default is
Handles implicitly for all windows.


NoIcon

Disables icon from being visible when window is iconifyed.
That causes window to simply disappear when the app is
iconified. Refer to the EXAMPLES below for a method to make
all icons disappear.


NoIconTitle

Specifies that no title should be displayed under an iconified
app.


NoKDEHints

AfterStep will not honor KDE specific hints set on the
client's window. Opposite of HonorKDEHints.

See Also: HonorKDEHints.


NoMotifHints

Forces AfterStep to disregard Motif decoration and
functionality hints.


NoPPosition

Species that afterstep should ignore the PPosition field for
the specified window, in other words, the window can't choose
where to place itself. Adherence to the PPosition field is
required for some applications.


NoTitle

Specifies that afterstep should not put a title bar decoration
on the app. The is off by default.


NoTransientHints

Ignore transient hint - window will be treated as an
independent window.


NoXResources

Forces AfterStep to disregard XResources database when it
comes to window placement.


OverrideGravity NorthWest | North | NorthEast | West | Center | East
| SouthWest | South | SouthEast | Static

Some applications (notably xv) have been designed without
reading widely accepted and used standards such as ICCCM.
Gravity value is one of the hints that often get misplaced by
applications. As the result may exhibit weird placement
behaviour - such as windows moving to the top-left with each
resize or file opened. Try specifying StaticGravity for such
apps. Also some applications do not set gravity correctly. For
example you start an application with geometry +10-10 which
means SouthWestGravity and that should fix position of left
and bottom sides of the window. But window set its gravity to
NorthWestGravity instead and as the result window gets placed
further down to the bottom by the size of the framne
decorations. In this cases you can specify whatever gravity
you want and thus override those stupid apps.

See Also: Gravity type specification for further details.


ShortLiving

ShortLiving windows are always placed automatically and do not
affect AvoidCover stuff.


Slippery

This is the default setting - windows stay on the desktop they
were placed on, and do not "follow" viewport, when desk/view
changes.


StartIconic

Causes the app to start and immediately iconify itself to the
IconBox . The default is StartNormal implicitly for all
windows.


StartNormal

Disables the effects of StartIconic setting - window will not
be iconifyed upon startup. This is the default


StartsAnyWhere

Upon startup window will be placed onto the current desktop.
This is the implicit default setting for all windows.


StartsOnDesk number

Causes the app window to start on the specified desk number.
If SmartPlacement is used in the feel.name file, the window
will appear on the specified desk number, but will require
interaction to place it; unless it was called with geometry
settings. Specific Viewports are also allowed, refer to them
below. The default is StartsAnyWhere implicitly for all
windows.


StaysOnBack

Places window in Layer -1, essentially forcing it to go under
most other windows. Default Layer is 0.

NOTE: deprecated, use Layer instead.


StaysOnTop | StaysPut | StaysOnBack

Places window in Layer 1, making it go on TOP of most other
windows. Default Layer is 0.

NOTE: deprecated, use Layer instead.


StaysPut

Places window in default Layer 0, disabling effects of
StaysOnTop , StaysOnBack and Layer .

NOTE: deprecated, use Layer instead.


Sticky

Causes the app window to stick to it's location for each
desktop that becomes current, allowing the window to "follow"
while changings desks/ views. The default is Slippery
implicitly for all windows.


StickyStyle style

Specifies a MyStyle to be used for this window when it does
not have the keyboard focus, and is sticky. If style is
unspecified, the default sticky style will be used instead
(see SWindowStyle , below).


Title

Specifies that afterstep should put a title bar decoration on
the app. This the default.


UnfocusStyle style

Specifies a MyStyle to be used for this window when it does
not have the keyboard focus, and is not sticky. If style is
unspecified, the default unfocus style will be used instead
(see UWindowStyle , below).


UseAnyViewport

AfterStep will treat an application as if it is relative to
the desktop origin, when that application specifies its
geometry at the time of mapping.

See Also: UseCurrentViewport.


UseCurrentViewport

AfterStep will treat an application as if it is relative to
the current viewport's origin, when that application specifies
its geometry at the time of mapping.

See Also: UseAnyViewport.


VerticalTitle

Causes the window titlebar to be placed vertically along the
left side of the window, instead of horizontally across the
top.


ViewportX number

Specifies the coordinate along the x-axis that afterstep
should place a window. This allows opening a window on a
particular desk and view. number is measured in pixels and the
screen resolution is the outline of a desk's particular
boundaries; where it will then place it upon another desk or
view. Combined with ViewportY , a window can be given geometry
by afterstep and be placed in the desired desktop and view.


ViewportY number

Specifies the coordinate along the y-axis that afterstep
should place a window. This allows opening a window on a
particular desk and view. number is measured in pixels and the
screen resolution is the outline of a desk's particular
boundaries; where it will then place it upon another desk or
view. Combined with ViewportX , a window can be given geometry
by afterstep and be placed in the desired desktop and view.


WindowBox "window_box_name"

Requires AfterStep to use the specified WindowBox for
placement of this window.


WindowListHit

Specifies that the app name will be shown on both the internal
Window List (default click of mouse buttons 2 & 3 on the root
window), and the WinList(1) module bar. This is the default
implicitly for all windows.


WindowListSkip

Specifies that the app name will be omitted from both the
internal Window List (default click of mouse buttons 2 & 3 on
the root window), and the WinList(1) module bar. The default
is WindowListHit implicitly for all windows.


WindowOpacity

FIXME: add proper description here.


3rd Berkeley Distribution AfterStep v.2.2.12 ASDatabaseEntry(1)