ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/cvsroot/root-tail/root-tail.man
Revision: 1.2
Committed: Thu Mar 25 21:46:56 2004 UTC (22 years, 7 months ago) by pcg
Content type: application/x-troff-man
Branch: MAIN
Changes since 1.1: +4 -0 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 pcg 1.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 pcg 1.2 .RB [ \-id ID ]
21 pcg 1.1 .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 pcg 1.2 .BI "\-id" " ID"
56     Use the given window id for output instead of the root window.
57     .TP
58 pcg 1.1 .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