| 1 |
.TH ROOTTAIL 1 "Nov 13, 2000" "Version 0.0.10" |
| 2 |
.UC 5 |
| 3 |
.SH NAME |
| 4 |
root-tail \- print text directly to X11 root window |
| 5 |
.SH SYNOPSIS |
| 6 |
.B root-tail |
| 7 |
.RB [ \-g \|| -geometry |
| 8 |
.IR GEOMETRY ] |
| 9 |
.RB [ \-fn \|| -font |
| 10 |
.IR FONTSPEC ] |
| 11 |
.RB [ \-color |
| 12 |
.IR color ] |
| 13 |
.RB [ \-reload |
| 14 |
.IR SEC |
| 15 |
.IR COMMAND ] |
| 16 |
.RB [ \-shade ] |
| 17 |
.RB [ \-f \|| \-fork ] |
| 18 |
.RB [ \-noinitial ] |
| 19 |
.RB [ \-frame ] |
| 20 |
.RB [ \-id ID ] |
| 21 |
.RB [ \-i \|| \-interval |
| 22 |
.IR SECONDS ] |
| 23 |
.RB [ \-V ] |
| 24 |
file1[,color[,desc]] |
| 25 |
[file2[,color[,desc]]] |
| 26 |
.\" Die Beschreibung |
| 27 |
.SH DESCRIPTION |
| 28 |
Displays a given file anywhere on your X11 root window with a transparent |
| 29 |
background. It was made because I'm very lazy and this was easier than |
| 30 |
making a new rxvt pixmap each time I changed my background to simulate |
| 31 |
that transparent effect. A null desc (example: "/var/log/messages,red,") |
| 32 |
will prevent the printing of a description and the []'s. |
| 33 |
.PP |
| 34 |
.SS General Options |
| 35 |
.TP |
| 36 |
.BI \-color " COLOR" |
| 37 |
Use color $color as default. |
| 38 |
.TP |
| 39 |
.BI "\-font \|| -fn" " FONTSPEC" |
| 40 |
Use font FONTSPEC this can be either fixed withn fonts like -fn fixed or any font using -fn '-*-*-*-*-*-*-*-*-*-*-*-*-*-*' with the appropriate fields filled out (see xfontsel) |
| 41 |
.TP |
| 42 |
.B -f \|| \-fork |
| 43 |
Forks to the background and gives the pid of itself (useful if rt is being called from a script or frontend) |
| 44 |
.IP |
| 45 |
.TP |
| 46 |
.BI \-reload " SEC COMMAND" |
| 47 |
Run command & run command after $sec seconds. |
| 48 |
.TP |
| 49 |
.B \-shade |
| 50 |
Add shading to font. |
| 51 |
.TP |
| 52 |
.B \-noinitial |
| 53 |
Don't display the end of the file(s) initially. |
| 54 |
.TP |
| 55 |
.BI "\-id" " ID" |
| 56 |
Use the given window id for output instead of the root window. |
| 57 |
.TP |
| 58 |
.BI "\-i \|| \-interval" " SECONDS" |
| 59 |
Use the specified sleeping interval between checks instead of the default 3 seconds. Fractional values are o.k. |
| 60 |
.TP |
| 61 |
.B \-V |
| 62 |
Print version information. |
| 63 |
.TP |
| 64 |
.B \-frame |
| 65 |
Surround the selected area with a frame. This is just a debugging tool and doesn't always work properly. Use it to find |
| 66 |
the perfect geometry. |
| 67 |
.IP |
| 68 |
.SH EXAMPLE |
| 69 |
.PP |
| 70 |
root-tail -g 80x25+100+50 /var/log/messages,green /var/log/secure,red,'ALERT' |
| 71 |
.SH BUGS |
| 72 |
.PP |
| 73 |
\- width must be larger than the longest file-header, otherwise segfaults. |
| 74 |
.PP |
| 75 |
Should you happen to find any bugs please fix them and send me a diff. |
| 76 |
.PP |
| 77 |
NOTE: This program was modified by Marc Lehmann <pcg@goof.com>, who |
| 78 |
couldn't reach the original author. Please direct bug-reports etc.. to pcg@goof.com. |
| 79 |
.PP |
| 80 |
http://root-tail.plan9.de/ |
| 81 |
|
