Merge pull request #536 from TheMC47/add-loggers-reference

Documentation tweaks for `X.H.StatusBar(.PP)`

XMonad/Hooks/StatusBar.hs

@@ -339,6 +339,9 @@ statusBarPipe cmd xpp  = do
 -- property, their content will be the same. If you want to use property-based
 -- logging with multiple bars, they should read from different properties.
 --
+-- "XMonad.Util.Loggers" includes loggers that can be bound to specific screens,
+-- like 'logCurrentOnScreen', that might be useful with multiple screens.
+--
 -- Long-time xmonad users will note that the above config is equivalent to
 -- the following less robust and more verbose configuration that they might
 -- find in their old configs:

XMonad/Hooks/StatusBar/PP.hs

@@ -68,9 +68,8 @@ import XMonad.Hooks.UrgencyHook
 -- > import XMonad.Hooks.StatusBar.PP
 -- >
 -- > myPP = def { ppCurrent = xmobarColor "black" "white" }
--- > main = do
--- >   mySB <- statusBarProp "xmobar" (pure myPP)
--- >   xmonad =<< withEasySB mySB defToggleStrutsKey myConfig
+-- > mySB = statusBarProp "xmobar" (pure myPP)
+-- > main = xmonad . withEasySB mySB defToggleStrutsKey $ myConfig
 --
 -- Check "XMonad.Hooks.StatusBar" for more examples and an in depth
 -- explanation.
@@ -101,7 +100,9 @@ data PP = PP { ppCurrent :: WorkspaceId -> String
              , ppWsSep :: String
                -- ^ separator to use between workspace tags
              , ppTitle :: String -> String
-               -- ^ window title format for the focused window
+               -- ^ window title format for the focused window. To display
+               -- the titles of all windows—even unfocused ones—check
+               -- 'XMonad.Util.Loggers.logTitles'.
              , ppTitleSanitize :: String -> String
               -- ^ escape / sanitizes input to 'ppTitle'
              , ppLayout :: String -> String