Fix Documentation in X.H.FadeWindows

XMonad/Hooks/FadeWindows.hs

@@ -76,17 +76,26 @@ import           Graphics.X11.Xlib.Extras                (Event(..))
 -- >     , handleEventHook = fadeWindowsEventHook
 -- >     {- ... -}
 -- >
--- > myFadeHook = composeAll [isUnfocused --> transparency 0.2
+-- > myFadeHook = composeAll [                 opaque
--- >                         ,                opaque
+-- >                         , isUnfocused --> transparency 0.2
 -- >                         ]
 --
 -- The above is like FadeInactive with a fade value of 0.2.
 --
--- FadeHooks do not accumulate; instead, they compose from right to
+-- 'FadeHook's do not accumulate; instead, they compose from right to
--- left like 'ManageHook's, so the above example @myFadeHook@ will
+-- left like 'ManageHook's, so in the above example @myFadeHook@ will
--- render unfocused windows at 4/5 opacity and the focused window
+-- render unfocused windows at 4/5 opacity and the focused window as
--- as opaque.  The 'opaque' hook above is optional, by the way, as any
+-- opaque.  This means that, in particular, the order in the above
--- unmatched window will be opaque by default.
+-- example is important.
+--
+-- The 'opaque' hook above is optional, by the way, as any unmatched
+-- window will be opaque by default.  If you want to make all windows a
+-- bit transparent by default, you can replace 'opaque' with something
+-- like
+--
+-- > transparency 0.93
+--
+-- at the top of @myFadeHook@.
 --
 -- This module is best used with "XMonad.Hooks.MoreManageHelpers", which
 -- exports a number of Queries that can be used in either @ManageHook@