Release 1.6.0.
[xtoys] / xrepaint.1
1 .\" -*-nroff-*-
2 .TH xrepaint 1 "10 January 2016" "Straylight/Edgeware" "xtoys"
3 .SH NAME
4 xrepaint \- force repainting of X display, or just one screen
5 .SH SYNOPSIS
6 .B xrepaint
7 .RB [ \-as ]
8 .RB [ \-d
9 .IR display ]
10 .SH DESCRIPTION
11 The
12 .B xrepaint
13 program forces a repaint of the entire X display,
14 or maybe just a single screen.
15 .PP
16 Options are as follows.
17 .TP
18 .B "\-a, \-\-all"
19 Repaint all of the screens on the display.
20 This is the default.
21 .TP
22 .BI "\-d, \-\-display=" display
23 Sets the X display to connect to.
24 The default comes from the
25 .B DISPLAY
26 environment variable,
27 as usual.
28 .TP
29 .B "\-s, \-\-screen"
30 Repaint only the default screen selected by
31 .IR display .
32 The default is to repaint all of the screens.
33 .SH BUGS
34 If a compositing manager is present,
35 then
36 .B xrepaint
37 forces recompositing of the screen,
38 but if some client has painted rubbish into its window,
39 it won't be forced to repaint it.
40 .PP
41 The current approach is fundamentally incorrect.
42 It doesn't seem possible to know when I've actually succeeded
43 in forcing a repaint of the display.
44 .PP
45 The current behaviour seems to be good enough for the author's purposes.
46 .SH AUTHOR
47 Mark Wooding <mdw@distorted.org.uk>