1 |
<!-- Creator : groff version 1.22.4 --> |
2 |
<!-- CreationDate: Sun Jun 16 01:34:30 2019 --> |
3 |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
4 |
"http://www.w3.org/TR/html4/loose.dtd"> |
5 |
<html> |
6 |
<head> |
7 |
<meta name="generator" content="groff -Thtml, see www.gnu.org"> |
8 |
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> |
9 |
<meta name="Content-Style" content="text/css"> |
10 |
<style type="text/css"> |
11 |
p { margin-top: 0; margin-bottom: 0; vertical-align: top } |
12 |
pre { margin-top: 0; margin-bottom: 0; vertical-align: top } |
13 |
table { margin-top: 0; margin-bottom: 0; vertical-align: top } |
14 |
h1 { text-align: center } |
15 |
</style> |
16 |
<title>ROOTTAIL</title> |
17 |
|
18 |
</head> |
19 |
<body> |
20 |
|
21 |
<h1 align="center">ROOTTAIL</h1> |
22 |
|
23 |
<a href="#NAME">NAME</a><br> |
24 |
<a href="#SYNOPSIS">SYNOPSIS</a><br> |
25 |
<a href="#DESCRIPTION">DESCRIPTION</a><br> |
26 |
<a href="#EXAMPLE">EXAMPLE</a><br> |
27 |
<a href="#BUGS">BUGS</a><br> |
28 |
|
29 |
<hr> |
30 |
|
31 |
|
32 |
<h2>NAME |
33 |
<a name="NAME"></a> |
34 |
</h2> |
35 |
|
36 |
|
37 |
<p style="margin-left:11%; margin-top: 1em">root-tail - |
38 |
print text directly to X11 root window</p> |
39 |
|
40 |
<h2>SYNOPSIS |
41 |
<a name="SYNOPSIS"></a> |
42 |
</h2> |
43 |
|
44 |
|
45 |
|
46 |
<p style="margin-left:11%; margin-top: 1em"><b>root-tail</b> |
47 |
[<b>-g</b>|<b>--geometry</b> <i>GEOMETRY</i>] |
48 |
[<b>-fn</b>|<b>--font</b> <i>FONTSPEC</i>] [<b>--color</b> |
49 |
<i>color</i>] [<b>--reload</b> <i>SEC COMMAND</i>] |
50 |
[<b>--shade</b>] [<b>--outline</b>] [<b>--minspace</b>] |
51 |
[<b>--noflicker</b>] [<b>-f</b>|<b>--fork</b>] |
52 |
[<b>--reverse</b>] [<b>--whole</b>] [<b>--partial</b>] |
53 |
[<b>--update</b>] [<b>--cont</b> <i>STRING</i>] |
54 |
[<b>--wordwrap</b>] [<b>--justify</b>] [<b>--noinitial</b>] |
55 |
[<b>--frame</b>] [<b>--windowed</b>} [<b>-id</b> <i>ID</i>] |
56 |
[<b>-i</b>|<b>--interval</b> <i>SECONDS</i>] [<b>-V</b>] |
57 |
file1[,color[,desc]] [file2[,color[,desc]]]</p> |
58 |
|
59 |
<h2>DESCRIPTION |
60 |
<a name="DESCRIPTION"></a> |
61 |
</h2> |
62 |
|
63 |
|
64 |
<p style="margin-left:11%; margin-top: 1em">Displays a |
65 |
given file anywhere on your X11 root window, i.e. it is kind |
66 |
of tail -f for multiple files using your desktop background |
67 |
as output window.</p> |
68 |
|
69 |
<p style="margin-left:11%; margin-top: 1em">All non-option |
70 |
arguments on the command line are files to be logged. A null |
71 |
desc (example: "/var/log/messages,red,") will |
72 |
prevent the printing of a description and the |
73 |
[]’s.</p> |
74 |
|
75 |
<p style="margin-left:11%; margin-top: 1em"><b>General |
76 |
Options <br> |
77 |
--color</b> <i>COLOR</i></p> |
78 |
|
79 |
<p style="margin-left:22%;">Use COLOR as default.</p> |
80 |
|
81 |
<p style="margin-left:11%;"><b>--font | -fn</b> |
82 |
<i>FONTSPEC</i></p> |
83 |
|
84 |
<p style="margin-left:22%;">Use font FONTSPEC. This can be |
85 |
either a fixed width font like <b>-fn</b> <i>fixed</i> or |
86 |
any font using <b>-fn</b> |
87 |
’<i>-*-*-*-*-*-*-*-*-*-*-*-*-*-*</i>’ with the |
88 |
appropriate fields filled out (see xfontsel). Specifying a |
89 |
different FONTSPEC before each filename will cause each file |
90 |
to be displayed in a different font.</p> |
91 |
|
92 |
<p style="margin-left:11%;"><b>-f | --fork</b></p> |
93 |
|
94 |
<p style="margin-left:22%;">Forks to the background.</p> |
95 |
|
96 |
<p style="margin-left:11%;"><b>--reverse</b></p> |
97 |
|
98 |
<p style="margin-left:22%;">Display the files in reverse |
99 |
order, with the newest lines at the top.</p> |
100 |
|
101 |
<p style="margin-left:11%;"><b>--whole</b></p> |
102 |
|
103 |
<p style="margin-left:22%;">Only display whole lines. If |
104 |
the last line of a file doesn’t yet end with a newline |
105 |
character then wait until it does before displaying it. This |
106 |
is the default if more than one file is being displayed.</p> |
107 |
|
108 |
<p style="margin-left:11%;"><b>--partial</b></p> |
109 |
|
110 |
<p style="margin-left:22%;">This is the opposite of the |
111 |
<b>--whole</b> option (see above). It displays lines even if |
112 |
they don’t yet have a newline at the end. This is the |
113 |
default if only one file is being displayed.</p> |
114 |
|
115 |
<p style="margin-left:11%;"><b>--update</b></p> |
116 |
|
117 |
<p style="margin-left:22%;">Update partial lines ’in |
118 |
place’ if they are still on the screen when they are |
119 |
updated in their files. Using <b>--update</b> automatically |
120 |
turns on <b>--partial</b>.</p> |
121 |
|
122 |
<p style="margin-left:11%;"><b>--cont</b> <i>STRING</i></p> |
123 |
|
124 |
<p style="margin-left:22%;">When partial lines are broken |
125 |
into two lines in the display, prefix the 2nd line with |
126 |
STRING. Defaults to "<i>||</i> ". Specify the |
127 |
"<b>--whole</b>" argument to ensure partial lines |
128 |
are never displayed, or specify "<b>--update</b>" |
129 |
to attempt to "repair" broken lines in-place.</p> |
130 |
|
131 |
<p style="margin-left:11%;"><b>--cont-color</b> |
132 |
<i>COLOR</i></p> |
133 |
|
134 |
<p style="margin-left:22%;">Use COLOR when displaying the |
135 |
continuation string (as optionally specified with the |
136 |
<b>--cont</b> option above).</p> |
137 |
|
138 |
<p style="margin-left:11%;"><b>--wordwrap</b></p> |
139 |
|
140 |
<p style="margin-left:22%;">The default behaviour is to fit |
141 |
as much as possible onto each line of output, even if this |
142 |
means splitting a word between one line and the next. The |
143 |
<b>--wordwrap</b> argument splits lines at spaces if |
144 |
possible.</p> |
145 |
|
146 |
<p style="margin-left:11%;"><b>--justify</b></p> |
147 |
|
148 |
<p style="margin-left:22%;">After wrapping long lines, |
149 |
attempt to justify the text to produce a smooth right-hand |
150 |
margin. Implies <b>--wordwrap</b>.</p> |
151 |
|
152 |
<p style="margin-left:11%;"><b>--reload</b> <i>SEC |
153 |
COMMAND</i></p> |
154 |
|
155 |
<p style="margin-left:22%;">Re-display the file(s) and run |
156 |
COMMAND every SEC seconds. The default is to never |
157 |
re-display the file(s).</p> |
158 |
|
159 |
<p style="margin-left:11%;"><b>--shade</b></p> |
160 |
|
161 |
<p style="margin-left:22%;">Add black shading to the |
162 |
font.</p> |
163 |
|
164 |
<p style="margin-left:11%;"><b>--outline</b></p> |
165 |
|
166 |
<p style="margin-left:22%;">Add a black outline to the font |
167 |
(making redraws quite a bit slower).</p> |
168 |
|
169 |
<p style="margin-left:11%;"><b>--minspace</b></p> |
170 |
|
171 |
<p style="margin-left:22%;">Use minimum linespace even when |
172 |
using shading or outlining. This might result in leftover |
173 |
pixels (dependign on font and logfile content).</p> |
174 |
|
175 |
<p style="margin-left:11%;"><b>--noflicker</b></p> |
176 |
|
177 |
<p style="margin-left:22%;">Use slower but flicker-free |
178 |
update.</p> |
179 |
|
180 |
<p style="margin-left:11%;"><b>--noinitial</b></p> |
181 |
|
182 |
<p style="margin-left:22%;">Don’t display the end of |
183 |
the file(s) initially.</p> |
184 |
|
185 |
<p style="margin-left:11%;"><b>--windowed</b></p> |
186 |
|
187 |
<p style="margin-left:22%;">Create a new window instead of |
188 |
reusing the root window. The newly created window covers the |
189 |
whole screen, puts itself behind all other windows and and |
190 |
does not accept events. Use this option if you use a |
191 |
compositing manager suihc as xcompmgr or compton, as the |
192 |
compositing extension has been very badly designed and |
193 |
cannot handle root windows correctly.</p> |
194 |
|
195 |
<table width="100%" border="0" rules="none" frame="void" |
196 |
cellspacing="0" cellpadding="0"> |
197 |
<tr valign="top" align="left"> |
198 |
<td width="11%"></td> |
199 |
<td width="9%"> |
200 |
|
201 |
|
202 |
<p><b>-id</b> <i>ID</i></p></td> |
203 |
<td width="2%"></td> |
204 |
<td width="78%"> |
205 |
|
206 |
|
207 |
<p>Use the given window ID for output instead of the root |
208 |
window.</p> </td></tr> |
209 |
</table> |
210 |
|
211 |
<p style="margin-left:11%;"><b>-i | --interval</b> |
212 |
<i>SECONDS</i></p> |
213 |
|
214 |
<p style="margin-left:22%;">Use the specified sleeping |
215 |
interval between checks instead of the default 2.4 seconds. |
216 |
Fractional values are OK.</p> |
217 |
|
218 |
<table width="100%" border="0" rules="none" frame="void" |
219 |
cellspacing="0" cellpadding="0"> |
220 |
<tr valign="top" align="left"> |
221 |
<td width="11%"></td> |
222 |
<td width="3%"> |
223 |
|
224 |
|
225 |
<p><b>-V</b></p></td> |
226 |
<td width="8%"></td> |
227 |
<td width="40%"> |
228 |
|
229 |
|
230 |
<p>Print version information.</p></td> |
231 |
<td width="38%"> |
232 |
</td></tr> |
233 |
</table> |
234 |
|
235 |
<p style="margin-left:11%;"><b>--frame</b></p> |
236 |
|
237 |
<p style="margin-left:22%;">Draw a frame around the |
238 |
selected area. This is useful when trying to find the |
239 |
perfect geometry.</p> |
240 |
|
241 |
<h2>EXAMPLE |
242 |
<a name="EXAMPLE"></a> |
243 |
</h2> |
244 |
|
245 |
|
246 |
<p style="margin-left:11%; margin-top: 1em">root-tail |
247 |
--windowed -g 800x250+100+50 -font 10x20 |
248 |
/var/log/messages,green -font 12x24 |
249 |
/var/log/secure,red,’ALERT’</p> |
250 |
|
251 |
<h2>BUGS |
252 |
<a name="BUGS"></a> |
253 |
</h2> |
254 |
|
255 |
|
256 |
<p style="margin-left:11%; margin-top: 1em">Some desktop |
257 |
environments open a virtual root window and make it |
258 |
difficult to share it. If you cannot see anything after |
259 |
starting root-tail, try the --windowed option, a setting |
260 |
"allow programs on desktop" or similar, or |
261 |
manually specify a window id.</p> |
262 |
|
263 |
<p style="margin-left:11%; margin-top: 1em">Should you |
264 |
happen to find any bugs please fix them and send me a |
265 |
diff.</p> |
266 |
|
267 |
<p style="margin-left:11%; margin-top: 1em">NOTE: This |
268 |
program was modified by Marc Lehmann |
269 |
<schmorp@schmorp.de>, who couldn’t reach the |
270 |
original author. Please direct bug-reports etc. to |
271 |
root-tail@schmorp.de.</p> |
272 |
|
273 |
|
274 |
<p style="margin-left:11%; margin-top: 1em">http://software.schmorp.de/pkg/root-tail.html</p> |
275 |
<hr> |
276 |
</body> |
277 |
</html> |