--- name: "ASDatabaseEntry" section: "1x" platform: "linux" package: "afterstep" version: "2.2.12-15+b2" release: "Debian 12 (Bookworm)" platforms: ["linux"] url: "https://new.carta.tech/ASDatabaseEntry" --- # ASDatabaseEntry(1x) to be used in entry of AfterStep database ## 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.