.\" t .\" @(#)ASDatabaseEntry.1 08/31/2018 .TH ASDatabaseEntry 1x "AfterStep v.2.2.12" "Aug 31 2018" "AfterStep X11 window manager" .UC .SH NAME \fBASDatabaseEntry\fP\ \- to be used in entry of AfterStep database .SH CONFIGURATION OPTIONS .IP " \fIAllowCover\fP " Specifies that other windows should be allowed to cover the app window\&. Turns off \fIAvoidCover\fP \&. This is the default setting\&. .IP " \fIAvoidCover\fP " 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 \fISmartPlacement\fP is specified in the \fIfeel\fP file, windows will not be allowed to automatically place themselves over the app window, if possible\&. \fIAllowCover\fP turns off \fIAvoidCover\fP \&. The default is \fIAllowCover\fP \&. .IP "BorderWidth \fIwidth\fP " Specifying this in conjunction with \fINoHandles\fP , sets the border width of a window to be \fIwidth\fP \&. A \fIwidth\fP of0causes no border\&. This option has no affect if not used with \fINoHandles\fP \&. The default is1implicitly for all windows\&. .IP "Button \fInumber\fP " Specifying a \fInumber\fP to each use of \fIButton\fP will cause that buttons number to be displayed in the title bar\&. Number should be the same as used in \fITitleButtons\fP setting\&. The default is to display all buttons defined in the \fIlook\&.name\fP file if the following conditions are met: there is a valid bitmap or pixmap specified for the button in the \fIlook\&.name\fP file; nd the button has not been forced not to display by the use of Motif WM hints specified by application\&. .IP " \fICirculateHit\fP " Enables window to be switched to using ChangeWindowUp, ChangeWindowDown or Warp (also called alt\-tabbing) functions\&. This is the default implicitly for all windows\&. .IP " \fICirculateSkip\fP " 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\&. .IP "DefaultGeometry \fIWIDTHxHEIGHT+X+Y\fP " 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 .IP " \fIFocus\fP " This will set the window to accept input focus\&. The is the default for all windows\&. .IP "FocusOnMap" Client window will be focused when it is mapped even if it is not directly under mouse pointer\&. .IP "FocusStyle [ \fIstyle\fP ]" Specifies a MyStyle to be used for this window when it has the keyboard focus\&. If \fIstyle\fP is unspecified, the default focus style will be used instead (see \fIFWindowStyle\fP , below)\&. .IP "Frame \fI""frame_name""\fP " Enables "frame_name" to be used for decoration of this window\&. .IP "Fullscreen" Makes window Fullscreen on startup\&. .IP "HandleWidth \fIwidth\fP " Specifies the \fIwidth\fP of the resize handles on the The default \fIwidth\fP is8pixels\&. .IP " \fIHandles\fP " Specifies that the app window will display the "low bar" decoration\&. This is the default for all windows\&. .IP "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\&. .IP "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\&. .IP "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\&. .IP "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\&. .IP "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\&. .IP "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\&. .IP "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\&. .IP "HonorRestack" FIXME: add proper description here\&. .IP "HonorTransientHints" Will force AfterStep to use transient hint, effectively attaching window to its parent( placing it on the same layer , etc\&. ) .IP "HonorXResources" Forces AfterStep to respect XResources database when it comes to window placement\&. .IP " \fIHorizontalTitle\fP " Causes the window titlebar to be placed horizontally on top of the window\&. This is the implicit default for all windows\&. .IP "Icon \fIfilename\fP " Specifies the [filename] to use when iconified, overriding any icon the app itself might provide\&. \fINoIcon\fP turns this off\&. The default is to use the app's supplied icon or the icon specified with the WM_NAME of "Unknown" or "*"\&. .IP " \fIIconTitle\fP " Specifies that a title should be displayed under an iconified app\&. The colors used are the \fIForeColor\fP and \fIBackColor\fP of the \fIButtonTitleFocus\fP in the \fIlook\&.name\fP 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\&. .IP "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\&. .IP "IgnoreRestack" FIXME: add proper description here\&. .IP "Layer \fIlayer\fP " Specifies what layer this window should be in\&. \fIlayer\fP 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\&. \fIStaysOnBack\fP corresponds toLayer \-1, and \fIStaysOnTop\fP corresponds to \fILayer 1\fP \&. .IP "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\&. .IP "NoButton \fInumber\fP " Specifying a \fInumber\fP to each use of \fINoButton\fP will cause that buttons be hidden from the title bar\&. Number should be the same as used in \fITitleButtons\fP setting\&. The default is to display all buttons defined in the \fIlook\&.name\fP file if the following conditions are met: there is a valid bitmap or pixmap specified for the button in the \fIlook\&.name\fP file; and the button has not been forced not to display by the use of Motif WM hints specified by application\&. .IP "NoExtWMHints" AfterStep will not use extended window management hints that the client sets on its windows\&. Opposite of HonorExtWMHints\&. See Also: HonorExtWMHints\&. .IP " \fINoFocus\fP " This will set the window to refuse any input focus\&. \fIFocus\fP will turn this setting off\&. This is off by default\&. .IP "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\&. .IP "NoFrame" Disables frame decorations for this window\&. .IP "NoFullscreen" Prevents windows from starting up as Fullscreen\&. .IP "NoGnomeHints" Causes AfterStep to disregard layer properties and several obsolete properties for a window\&. Opposite of HonorGnomeHints\&. See Also: HonorGnomeHints\&. .IP "NoGroupHints" AfterStep will not utilize a group hint set on the client's window\&. Opposite of HonorGroupHints\&. See Also: HonorGroupHints\&. .IP " \fINoHandles\fP " 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 \fIHandles\fP implicitly for all windows\&. .IP " \fINoIcon\fP " 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\&. .IP "NoIconTitle" Specifies that no title should be displayed under an iconified app\&. .IP "NoKDEHints" AfterStep will not honor KDE specific hints set on the client's window\&. Opposite of HonorKDEHints\&. See Also: HonorKDEHints\&. .IP "NoMotifHints" Forces AfterStep to disregard Motif decoration and functionality hints\&. .IP "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\&. .IP " \fINoTitle\fP " Specifies that \fBafterstep\fP should not put a title bar decoration on the app\&. The is off by default\&. .IP "NoTransientHints" Ignore transient hint \- window will be treated as an independent window\&. .IP "NoXResources" Forces AfterStep to disregard XResources database when it comes to window placement\&. .IP "OverrideGravity \fINorthWest | North | NorthEast | West | Center | East | SouthWest | South | SouthEast | Static\fP " 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\&. .IP "ShortLiving" ShortLiving windows are always placed automatically and do not affect AvoidCover stuff\&. .IP " \fISlippery\fP " This is the default setting \- windows stay on the desktop they were placed on, and do not "follow" viewport, when desk/view changes\&. .IP " \fIStartIconic\fP " Causes the app to start and immediately iconify itself to the \fIIconBox\fP \&. The default is \fIStartNormal\fP implicitly for all windows\&. .IP " \fIStartNormal\fP " Disables the effects of \fIStartIconic\fP setting \- window will not be iconifyed upon startup\&. This is the default .IP " \fIStartsAnyWhere\fP " Upon startup window will be placed onto the current desktop\&. This is the implicit default setting for all windows\&. .IP "StartsOnDesk \fInumber\fP " Causes the app window to start on the specified \fIdesk\fP number\&. If \fISmartPlacement\fP is used in the \fIfeel\&.name\fP file, the window will appear on the specified \fIdesk\fP number, but will require interaction to place it; unless it was called with geometry settings\&. Specific \fIViewports\fP are also allowed, refer to them below\&. The default is \fIStartsAnyWhere\fP implicitly for all windows\&. .IP " \fIStaysOnBack\fP " Places window in Layer \-1, essentially forcing it to go under most other windows\&. Default Layer is 0\&. \fINOTE: deprecated, use Layer instead\&.\fP .IP " \fIStaysOnTop\fP | \fIStaysPut\fP | \fIStaysOnBack\fP " Places window in Layer 1, making it go on TOP of most other windows\&. Default Layer is 0\&. \fINOTE: deprecated, use Layer instead\&.\fP .IP " \fIStaysPut\fP " Places window in default Layer 0, disabling effects of \fIStaysOnTop\fP , \fIStaysOnBack\fP and \fILayer\fP \&. \fINOTE: deprecated, use Layer instead\&.\fP .IP " \fISticky\fP " 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 \fISlippery\fP implicitly for all windows\&. .IP "StickyStyle \fIstyle\fP " Specifies a MyStyle to be used for this window when it does not have the keyboard focus, and is sticky\&. If \fIstyle\fP is unspecified, the default sticky style will be used instead (see \fISWindowStyle\fP , below)\&. .IP " \fITitle\fP " Specifies that \fBafterstep\fP should put a title bar decoration on the app\&. This the default\&. .IP "UnfocusStyle \fIstyle\fP " Specifies a MyStyle to be used for this window when it does not have the keyboard focus, and is not sticky\&. If \fIstyle\fP is unspecified, the default unfocus style will be used instead (see \fIUWindowStyle\fP , below)\&. .IP "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\&. .IP "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\&. .IP " \fIVerticalTitle\fP " Causes the window titlebar to be placed vertically along the left side of the window, instead of horizontally across the top\&. .IP "ViewportX \fInumber\fP " Specifies the coordinate along the x\-axis that \fBafterstep\fP should place a window\&. This allows opening a window on a particular desk and view\&. \fInumber\fP 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 \fIViewportY\fP , a window can be given geometry by \fBafterstep\fP and be placed in the desired desktop and view\&. .IP "ViewportY \fInumber\fP " Specifies the coordinate along the y\-axis that \fBafterstep\fP should place a window\&. This allows opening a window on a particular desk and view\&. \fInumber\fP 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 \fIViewportX\fP , a window can be given geometry by \fBafterstep\fP and be placed in the desired desktop and view\&. .IP "WindowBox \fI""window_box_name""\fP " Requires AfterStep to use the specified WindowBox for placement of this window\&. .IP " \fIWindowListHit\fP " 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 \fIWinList(1)\fP module bar\&. This is the default implicitly for all windows\&. .IP " \fIWindowListSkip\fP " 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 \fIWinList(1)\fP module bar\&. The default is \fIWindowListHit\fP implicitly for all windows\&. .IP "WindowOpacity" FIXME: add proper description here\&.