xmonad-contrib v0.14 Release Notes
Release Date: 2018-07-31 // over 5 years ago-
๐ฅ Breaking Changes
XMonad.Layout.Spacing
Rewrite
XMonad.Layout.Spacing
. Borders are no longer uniform but composed of four sides each with its own border width. The screen and window borders are now separate and can be independently toggled on/off. The screen border examines the window/rectangle list resulting from 'runLayout' rather than the stack, which makes it compatible with layouts such as the builtinFull
. The child layout will always be called with the screen border. If only a single window is displayed (andsmartBorder
enabled), it will be expanded into the original layout rectangle. Windows that are displayed but not part of the stack, such as those created by 'XMonad.Layout.Decoration', will be shifted out of the way, but not scaled (not possible for windows created by XMonad). This isn't perfect, so you might want to disableSpacing
on such layouts.XMonad.Util.SpawnOnce
- Added
spawnOnOnce
,spawnNOnOnce
andspawnAndDoOnce
. These are useful in startup hooks to shift spawned windows to a specific workspace.
- Added
Adding handling of modifySpacing message in smartSpacing and smartSpacingWithEdge layout modifier
XMonad.Actions.GridSelect
- Added field
gs_bordercolor
toGSConfig
to specify border color.
- Added field
XMonad.Layout.Minimize
Though the interface it offers is quite similar, this module has been almost completely rewritten. The new
XMonad.Actions.Minimize
contains several functions that allow interaction with minimization window state. If you are using this module, you must upgrade your configuration to importX.A.Minimize
and usemaximizeWindow
andwithLastMinimized
instead of sending messages toMinimized
layout.XMonad.Hooks.RestoreMinimized
has been completely deprecated, and its functions have no effect.XMonad.Prompt.Unicode
unicodePrompt :: String -> XPConfig -> X ()
now additionally takes a filepath to theUnicodeData.txt
file containing unicode data.
XMonad.Actions.PhysicalScreens
getScreen
,viewScreen
,sendToScreen
,onNextNeighbour
,onPrevNeighbour
now need a extra parameter of typeScreenComparator
. This allow the user to specify how he want his screen to be ordered default value are:def
(same as verticalScreenOrderer) will keep previous behaviorverticalScreenOrderer
horizontalScreenOrderer
One can build his custom ScreenOrderer using:
screenComparatorById
(allow to order by Xinerama id)screenComparatorByRectangle
(allow to order by screen coordonate)ScreenComparator
(allow to mix ordering by screen coordonate and xinerama id)
XMonad.Util.WorkspaceCompare
getXineramaPhysicalWsCompare
now need a extra argument of typeScreenComparator
defined inXMonad.Actions.PhysicalScreens
(see changelog of this module for more information)XMonad.Hooks.EwmhDesktops
- Simplify ewmhDesktopsLogHookCustom, and remove the gnome-panel specific remapping of all visible windows to the active workspace (#216).
- Handle workspace renames that might be occuring in the custom function that is provided to ewmhDesktopsLogHookCustom.
XMonad.Hooks.DynamicLog
- Support xmobar's <action> and <raw> tags; see
xmobarAction
andxmobarRaw
.
- Support xmobar's <action> and <raw> tags; see
XMonad.Layout.NoBorders
The layout now maintains a list of windows that never have borders, and a list of windows that always have borders. Use
BorderMessage
to manage these lists and the accompanying event hook (borderEventHook
) to remove destroyed windows from them. Also provides thehasBorder
manage hook.Two new conditions have been added to
Ambiguity
:OnlyLayoutFloat
andOnlyLayoutFloatBelow
;OnlyFloat
was renamed toOnlyScreenFloat
. See the documentation for more information.The type signature of
hiddens
was changed to accept a newRectangle
parameter representing the bounds of the parent layout, placed after theWindowSet
parameter. Anyone defining a new instance ofSetsAmbiguous
will need to update their configuration. For example, replace "hiddens amb wset mst wrs =
" either with "hiddens amb wset _ mst wrs =
" or to make use of the new parameter with "hiddens amb wset lr mst wrs =
".XMonad.Actions.MessageFeedback
- Follow the naming conventions of
XMonad.Operations
. Functions returningX ()
are named regularly (previously these ended in underscore) while those returningX Bool
are suffixed with an uppercase 'B'. - Provide all
X Bool
andSomeMessage
variations forsendMessage
andsendMessageWithNoRefresh
, not justsendMessageWithNoRefreshToCurrent
(renamed fromsend
). - The new
tryInOrderB
andtryMessageB
functions accept a parameter of typeSomeMessage -> X Bool
, which means you are no longer constrained to the behavior of thesendMessageWithNoRefreshToCurrent
dispatcher. - The
send*Messages*
family of funtions allows for sequencing arbitrary sets of messages with minimal refresh. It makes little sense for these functions to support custom message dispatchers. - Remain backwards compatible. Maintain deprecated aliases of all renamed
functions:
send
->sendMessageWithNoRefreshToCurrentB
sendSM
->sendSomeMessageWithNoRefreshToCurrentB
sendSM_
->sendSomeMessageWithNoRefreshToCurrent
tryInOrder
->tryInOrderWithNoRefreshToCurrentB
tryInOrder_
->tryInOrderWithNoRefreshToCurrent
tryMessage
->tryMessageWithNoRefreshToCurrentB
tryMessage_
->tryMessageWithNoRefreshToCurrent
- Follow the naming conventions of
๐ New Modules
XMonad.Layout.MultiToggle.TabBarDecoration
Provides a simple transformer for use with
XMonad.Layout.MultiToggle
to dynamically toggleXMonad.Layout.TabBarDecoration
.XMonad.Hooks.RefocusLast
Provides hooks and actions that keep track of recently focused windows on a per workspace basis and automatically refocus the last window on loss of the current (if appropriate as determined by user specified criteria).
XMonad.Layout.StateFull
Provides
StateFull
: a stateful form ofFull
that does not misbehave when floats are focused, and theFocusTracking
layout transformer by means of whichStateFull
is implemented.FocusTracking
simply holds onto the last true focus it was given and continues to use it as the focus for the transformed layout until it sees another. It can be used to improve the behaviour of a child layout that has not been given the focused window.XMonad.Actions.SwapPromote
Module for tracking master window history per workspace, and associated functions for manipulating the stack using such history.
XMonad.Actions.CycleWorkspaceByScreen
A new module that allows cycling through previously viewed workspaces in the order they were viewed most recently on the screen where cycling is taking place.
Also provides the
repeatableAction
helper function which can be used to build actions that can be repeated while a modifier key is held down.XMonad.Prompt.FuzzyMatch
Provides a predicate
fuzzyMatch
that is much more lenient in matching completions inXMonad.Prompt
than the default prefix match. Also provides a functionfuzzySort
that allows sorting the fuzzy matches by "how well" they match.XMonad.Utils.SessionStart
A new module that allows to query if this is the first time xmonad is started of the session, or a xmonad restart.
Currently needs manual setting of the session start flag. This could be automated when this moves to the core repository.
XMonad.Layout.MultiDishes
A new layout based on Dishes, however it accepts additional configuration to allow multiple windows within a single stack.
XMonad.Util.Rectangle
A new module for handling pixel rectangles.
XMonad.Layout.BinaryColumn
A new module which provides a simple grid layout, halving the window sizes of each window after master.
This is similar to Column, but splits the window in a way that maintains window sizes upon adding & removing windows as well as the option to specify a minimum window size.
๐ Bug Fixes and Minor Changes
XMonad.Layout.Grid
Fix as per issue #223; Grid will no longer calculate more columns than there are windows.
XMonad.Hooks.FadeWindows
Added support for GHC version 8.4.x by adding a Semigroup instance for Monoids
XMonad.Hooks.WallpaperSetter
Added support for GHC version 8.4.x by adding a Semigroup instance for Monoids
XMonad.Hooks.Mosaic
Added support for GHC version 8.4.x by adding a Semigroup instance for Monoids
XMonad.Actions.Navigation2D
Added
sideNavigation
and a parameterised variant, providing a navigation strategy with fewer quirks for tiled layouts using X.L.Spacing.XMonad.Layout.Fullscreen
The fullscreen layouts will now not render any window that is totally obscured by fullscreen windows.
XMonad.Layout.Gaps
Extended the sendMessage interface with
ModifyGaps
to allow arbitrary modifications to theGapSpec
.XMonad.Layout.Groups
Added a new
ModifyX
message type that allows the modifying function to return values in theX
monad.XMonad.Actions.Navigation2D
Generalised (and hence deprecated) hybridNavigation to hybridOf.
XMonad.Layout.LayoutHints
Preserve the window order of the modified layout, except for the focused window that is placed on top. This fixes an issue where the border of the focused window in certain situations could be rendered below borders of unfocused windows. It also has a lower risk of interfering with the modified layout.
XMonad.Layout.MultiColumns
The focused window is placed above the other windows if they would be made to overlap due to a layout modifier. (As long as it preserves the window order.)
XMonad.Actions.GridSelect
- The vertical centring of text in each cell has been improved.
XMonad.Actions.SpawnOn
- Bind windows spawns by child processes of the original window to the same workspace as the original window.
XMonad.Util.WindowProperties
- Added the ability to test if a window has a tag from
XMonad.Actions.TagWindows
- Added the ability to test if a window has a tag from
XMonad.Layout.Magnifier
- Handle
IncMasterN
messages.
- Handle
XMonad.Util.EZConfig
- Can now parse Latin1 keys, to better accommodate users with non-US keyboards.
XMonad.Actions.Submap
Establish pointer grab to avoid freezing X, when button press occurs after submap key press. And terminate submap at button press in the same way, as we do for wrong key press.
XMonad.Hooks.SetWMName
Add function
getWMName
.XMonad.Hooks.ManageHelpers
- Make type of ManageHook combinators more general.
- New manage hook
doSink
for sinking windows (as upposed to thedoFloat
manage hook)
XMonad.Prompt
Export
insertString
.XMonad.Prompt.Window
- New function:
windowMultiPrompt
for usingmkXPromptWithModes
with window prompts.
- New function:
XMonad.Hooks.WorkspaceHistory
- Now supports per screen history.
XMonad.Layout.ComboP
- New
PartitionWins
message to re-partition all windows into the configured sub-layouts. Useful when window properties have changed and you want to re-sort windows into the appropriate sub-layout.
- New
XMonad.Actions.Minimize
- Now has
withFirstMinimized
andwithFirstMinimized'
so you can perform actions with both the last and first minimized windows easily.
- Now has
XMonad.Config.Gnome
- Update logout key combination (modm+shift+Q) to work with modern
XMonad.Prompt.Pass
- New function
passTypePrompt
which usesxdotool
to type in a password from the store, bypassing the clipboard. - New function
passEditPrompt
for editing a password from the store. - Now handles password labels with spaces and special characters inside them.
- New function
XMonad.Prompt.Unicode
- Persist unicode data cache across XMonad instances due to
ExtensibleState
now used instead ofunsafePerformIO
. typeUnicodePrompt :: String -> XPConfig -> X ()
provided to insert the Unicode character viaxdotool
instead of copying it to the paste buffer.mkUnicodePrompt :: String -> [String] -> String -> XPConfig -> X ()
acts as a generic function to pass the selected Unicode character to any program.
- Persist unicode data cache across XMonad instances due to
XMonad.Prompt.AppendFile
- New function
appendFilePrompt'
which allows for transformation of the string passed by a user before writing to a file.
- New function
XMonad.Hooks.DynamicLog
- Added a new function
dzenWithFlags
which allows specifying the arguments passed todzen2
invocation. The behaviour of currentdzen
function is unchanged.
- Added a new function
XMonad.Util.Dzen
- Now provides functions
fgColor
andbgColor
to specify foreground and background color,align
andslaveAlign
to set text alignment, andlineCount
to enable a second (slave) window that displays lines beyond the initial (title) one.
- Now provides functions
XMonad.Hooks.DynamicLog
- Added optional
ppVisibleNoWindows
to differentiate between empty and non-empty visible workspaces in pretty printing.
- Added optional
XMonad.Actions.DynamicWorkspaceOrder
- Added
updateName
andremoveName
to better control ordering when workspace names are changed or workspaces are removed.
- Added
XMonad.Config.Azerty
- Added
belgianConfig
andbelgianKeys
to support Belgian AZERTY keyboards, which are slightly different from the French ones in the top row.
- Added