New tool `xrepaint'.

[xtoys] / xrepaint.1

diff --git a/xrepaint.1 b/xrepaint.1
new file mode 100644 (file)
index 0000000..6cfd9d9
--- /dev/null
+++ b/xrepaint.1
@@ -0,0 +1,47 @@
+.\" -*-nroff-*-
+.TH xrepaint 1 "10 January 2016" "Straylight/Edgeware" "xtoys"
+.SH NAME
+xrepaint \- force repainting of X display, or just one screen
+.SH SYNOPSIS
+.B xrepaint
+.RB [ \-as ]
+.RB [ \-d
+.IR display ]
+.SH DESCRIPTION
+The
+.B xrepaint
+program forces a repaint of the entire X display,
+or maybe just a single screen.
+.PP
+Options are as follows.
+.TP
+.B "\-a, \-\-all"
+Repaint all of the screens on the display.
+This is the default.
+.TP
+.BI "\-d, \-\-display=" display
+Sets the X display to connect to.
+The default comes from the
+.B DISPLAY
+environment variable,
+as usual.
+.TP
+.B "\-s, \-\-screen"
+Repaint only the default screen selected by
+.IR display .
+The default is to repaint all of the screens.
+.SH BUGS
+If a compositing manager is present,
+then
+.B xrepaint
+forces recompositing of the screen,
+but if some client has painted rubbish into its window,
+it won't be forced to repaint it.
+.PP
+The current approach is fundamentally incorrect.
+It doesn't seem possible to know when I've actually succeeded
+in forcing a repaint of the display.
+.PP
+The current behaviour seems to be good enough for the author's purposes.
+.SH AUTHOR
+Mark Wooding <mdw@distorted.org.uk>