ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/root-tail/root-tail.man.html
Revision: 1.3
Committed: Sun Jun 16 01:34:45 2019 UTC (7 years, 3 months ago) by root
Content type: text/html
Branch: MAIN
CVS Tags: rel-1_3, HEAD
Changes since 1.2: +9 -8 lines
Log Message: 
*** empty log message ***

File Contents

# User Rev Content
1 root 1.2 <!-- Creator : groff version 1.22.4 -->
2 root 1.3 <!-- CreationDate: Sun Jun 16 01:34:30 2019 -->
3 root 1.2 <!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 root 1.1
18 root 1.2 </head>
19     <body>
20 root 1.1
21 root 1.2 <h1 align="center">ROOTTAIL</h1>
22 root 1.1
23 root 1.2 <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 root 1.1
29 root 1.2 <hr>
30 root 1.1
31    
32 root 1.2 <h2>NAME
33     <a name="NAME"></a>
34     </h2>
35 root 1.1
36    
37 root 1.2 <p style="margin-left:11%; margin-top: 1em">root-tail -
38     print text directly to X11 root window</p>
39 root 1.1
40 root 1.2 <h2>SYNOPSIS
41     <a name="SYNOPSIS"></a>
42     </h2>
43 root 1.1
44    
45    
46 root 1.2 <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 root 1.1
59 root 1.2 <h2>DESCRIPTION
60     <a name="DESCRIPTION"></a>
61     </h2>
62 root 1.1
63    
64 root 1.2 <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 root 1.1
69 root 1.2 <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: &quot;/var/log/messages,red,&quot;) will
72     prevent the printing of a description and the
73     []&rsquo;s.</p>
74 root 1.1
75 root 1.2 <p style="margin-left:11%; margin-top: 1em"><b>General
76     Options <br>
77     --color</b> <i>COLOR</i></p>
78 root 1.1
79 root 1.2 <p style="margin-left:22%;">Use COLOR as default.</p>
80 root 1.1
81 root 1.2 <p style="margin-left:11%;"><b>--font | -fn</b>
82     <i>FONTSPEC</i></p>
83 root 1.1
84 root 1.2 <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     &rsquo;<i>-*-*-*-*-*-*-*-*-*-*-*-*-*-*</i>&rsquo; 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 root 1.1
92 root 1.2 <p style="margin-left:11%;"><b>-f | --fork</b></p>
93 root 1.1
94 root 1.2 <p style="margin-left:22%;">Forks to the background.</p>
95 root 1.1
96 root 1.2 <p style="margin-left:11%;"><b>--reverse</b></p>
97 root 1.1
98 root 1.2 <p style="margin-left:22%;">Display the files in reverse
99     order, with the newest lines at the top.</p>
100 root 1.1
101 root 1.2 <p style="margin-left:11%;"><b>--whole</b></p>
102 root 1.1
103 root 1.2 <p style="margin-left:22%;">Only display whole lines. If
104     the last line of a file doesn&rsquo;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 root 1.1
108 root 1.2 <p style="margin-left:11%;"><b>--partial</b></p>
109 root 1.1
110 root 1.2 <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&rsquo;t yet have a newline at the end. This is the
113     default if only one file is being displayed.</p>
114 root 1.1
115 root 1.2 <p style="margin-left:11%;"><b>--update</b></p>
116 root 1.1
117 root 1.2 <p style="margin-left:22%;">Update partial lines &rsquo;in
118     place&rsquo; 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 root 1.1
122 root 1.2 <p style="margin-left:11%;"><b>--cont</b> <i>STRING</i></p>
123 root 1.1
124 root 1.2 <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 &quot;<i>||</i> &quot;. Specify the
127     &quot;<b>--whole</b>&quot; argument to ensure partial lines
128     are never displayed, or specify &quot;<b>--update</b>&quot;
129     to attempt to &quot;repair&quot; broken lines in-place.</p>
130 root 1.1
131 root 1.2 <p style="margin-left:11%;"><b>--cont-color</b>
132     <i>COLOR</i></p>
133 root 1.1
134 root 1.2 <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 root 1.1
138 root 1.2 <p style="margin-left:11%;"><b>--wordwrap</b></p>
139 root 1.1
140 root 1.2 <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 root 1.1
146 root 1.2 <p style="margin-left:11%;"><b>--justify</b></p>
147 root 1.1
148 root 1.2 <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 root 1.1
152 root 1.2 <p style="margin-left:11%;"><b>--reload</b> <i>SEC
153     COMMAND</i></p>
154 root 1.1
155 root 1.2 <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 root 1.1
159 root 1.2 <p style="margin-left:11%;"><b>--shade</b></p>
160 root 1.1
161 root 1.2 <p style="margin-left:22%;">Add black shading to the
162     font.</p>
163 root 1.1
164 root 1.2 <p style="margin-left:11%;"><b>--outline</b></p>
165 root 1.1
166 root 1.2 <p style="margin-left:22%;">Add a black outline to the font
167     (making redraws quite a bit slower).</p>
168 root 1.1
169 root 1.2 <p style="margin-left:11%;"><b>--minspace</b></p>
170 root 1.1
171 root 1.2 <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 root 1.1
175 root 1.2 <p style="margin-left:11%;"><b>--noflicker</b></p>
176 root 1.1
177 root 1.2 <p style="margin-left:22%;">Use slower but flicker-free
178     update.</p>
179 root 1.1
180 root 1.2 <p style="margin-left:11%;"><b>--noinitial</b></p>
181 root 1.1
182 root 1.2 <p style="margin-left:22%;">Don&rsquo;t display the end of
183     the file(s) initially.</p>
184 root 1.1
185 root 1.2 <p style="margin-left:11%;"><b>--windowed</b></p>
186 root 1.1
187 root 1.2 <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 root 1.1
195 root 1.2 <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 root 1.1
201    
202 root 1.2 <p><b>-id</b> <i>ID</i></p></td>
203     <td width="2%"></td>
204     <td width="78%">
205 root 1.1
206    
207 root 1.2 <p>Use the given window ID for output instead of the root
208     window.</p> </td></tr>
209     </table>
210 root 1.1
211 root 1.2 <p style="margin-left:11%;"><b>-i | --interval</b>
212     <i>SECONDS</i></p>
213 root 1.1
214 root 1.2 <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 root 1.1
218 root 1.2 <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 root 1.1
224    
225 root 1.2 <p><b>-V</b></p></td>
226     <td width="8%"></td>
227     <td width="40%">
228 root 1.1
229    
230 root 1.2 <p>Print version information.</p></td>
231     <td width="38%">
232     </td></tr>
233     </table>
234 root 1.1
235 root 1.2 <p style="margin-left:11%;"><b>--frame</b></p>
236 root 1.1
237 root 1.2 <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 root 1.1
241 root 1.2 <h2>EXAMPLE
242     <a name="EXAMPLE"></a>
243     </h2>
244 root 1.1
245    
246 root 1.2 <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,&rsquo;ALERT&rsquo;</p>
250 root 1.1
251 root 1.2 <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 root 1.3 starting root-tail, try the --windowed option, a setting
260     &quot;allow programs on desktop&quot; or similar, or
261     manually specify a window id.</p>
262 root 1.2
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 root 1.3 program was modified by Marc Lehmann
269     &lt;schmorp@schmorp.de&gt;, who couldn&rsquo;t reach the
270     original author. Please direct bug-reports etc. to
271     root-tail@schmorp.de.</p>
272 root 1.2
273    
274 root 1.3 <p style="margin-left:11%; margin-top: 1em">http://software.schmorp.de/pkg/root-tail.html</p>
275 root 1.2 <hr>
276     </body>
277     </html>