ftp://ftp.ntnu.no/old/pub/X11/R5contrib/xscreensaver-1.17.tar.gz
[xscreensaver] / hacks / noseguy.man
1 .TH XScreenSaver 1 "13-aug-92" "X Version 11"
2 .SH NAME
3 noseguy - a little guy with a big nose wanders around being witty
4 .SH SYNOPSIS
5 .B noseguy
6 [\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-text-foreground \fIcolor\fP] [\-text-background \fIcolor\fP] [\-font \fIfont\fP] [\-window] [\-root] [\-mode \fImode\fP] [\-program \fIprogram\fP] [\-filename \file\fP] [\-text \fItext\fP]
7 .SH DESCRIPTION
8 A little man with a big nose and a hat runs around spewing out messages to
9 the screen.  This code (and its bitmaps) were extracted from the \fIxnlock\fP
10 program.
11 .SH OPTIONS
12 .I noseguy
13 accepts the following options:
14 .TP 8
15 .B \-window
16 Draw on a newly-created window.  This is the default.
17 .TP 8
18 .B \-root
19 Draw on the root window.
20 .TP 8
21 .B \-font font
22 The font used for the messages.
23 .TP 8
24 .B \-mode program | file | string
25 In \fIprogram\fP mode, the messages are gotten by running a program.
26 The program used is controlled by the \fI\-program\fP option, and 
27 the \fI.program\fP resource.
28
29 In \fIfilename\fP mode, the message used is the contents of a file.
30 The file used is controlled by the \fI\-file\fP option, and 
31 the \fI.filename\fP resource.
32
33 In \fIstring\fP mode, the message is whatever was specified on the 
34 command line as the \fI\-text\fP option, or in the resource database
35 as the \fI.text\fP resource.
36 .TP 8
37 .B \-program " program"
38 If \fImode\fP is \fIprogram\fP (the default), then this program will be
39 run periodically, and its output will be the text of the messages.  The
40 default program is \fI"fortune -s"\fP, but \fIyow\fP is also a good choice.
41 .TP 8
42 .B \-filename file
43 If \fImode\fP is \fIfile\fP, then the contents of this file will be used
44 for all messages.
45 .TP 8
46 .B \-text string
47 If \fImode\fP is \fIstring\fP, then this text will be used for all messages.
48 .SH ENVIRONMENT
49 .PP
50 .TP 8
51 .B DISPLAY
52 to get the default host and display number.
53 .TP 8
54 .B XENVIRONMENT
55 to get the name of a resource file that overrides the global resources
56 stored in the RESOURCE_MANAGER property.
57 .SH SEE ALSO
58 .BR X (1),
59 .BR xscreensaver (1),
60 .BR xnlock (1)
61 .SH COPYRIGHT
62 Copyright 1985, 1990 by Dan Heller <argv@sun.com>.
63 .SH AUTHOR
64 Dan Heller <argv@sun.com>, 1985.
65
66 Ability to run standalone or with \fIxscreensaver\fP added by 
67 Jamie Zawinski <jwz@lucid.com>, 13-aug-92.