| 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> |