git.hungrycats.org Git - xscreensaver/blob - 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] [\-install] [\-visual \fIvisual\fP] [\-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 \-install
  22 Install a private colormap for the window.
  23 .TP 8
  24 .B \-visual \fIvisual\fP
  25 Specify which visual to use.  Legal values are the name of a visual class,
  26 or the id number (decimal or hex) of a specific visual.
  27 .TP 8
  28 .B \-font \fIfont\fP
  29 The font used for the messages.
  30 .TP 8
  31 .B \-mode [ program | file | string ]
  32 In \fIprogram\fP mode, the messages are gotten by running a program.
  33 The program used is controlled by the \fI\-program\fP option, and
  34 the \fI.program\fP resource.
  35
  36 In \fIfilename\fP mode, the message used is the contents of a file.
  37 The file used is controlled by the \fI\-file\fP option, and
  38 the \fI.filename\fP resource.
  39
  40 In \fIstring\fP mode, the message is whatever was specified on the
  41 command line as the \fI\-text\fP option, or in the resource database
  42 as the \fI.text\fP resource.
  43 .TP 8
  44 .B \-program \fIprogram\fP
  45 If \fImode\fP is \fIprogram\fP (the default), then this program will be
  46 run periodically, and its output will be the text of the messages.  The
  47 default program is \fI"fortune -s"\fP, but \fIyow\fP is also a good choice.
  48 .TP 8
  49 .B \-filename \fIfile\fP
  50 If \fImode\fP is \fIfile\fP, then the contents of this file will be used
  51 for all messages.
  52 .TP 8
  53 .B \-text \fIstring\fP
  54 If \fImode\fP is \fIstring\fP, then this text will be used for all messages.
  55 .SH ENVIRONMENT
  56 .PP
  57 .TP 8
  58 .B DISPLAY
  59 to get the default host and display number.
  60 .TP 8
  61 .B XENVIRONMENT
  62 to get the name of a resource file that overrides the global resources
  63 stored in the RESOURCE_MANAGER property.
  64 .SH SEE ALSO
  65 .BR X (1),
  66 .BR xscreensaver (1),
  67 .BR xnlock (1)
  68 .SH COPYRIGHT
  69 Copyright 1985, 1990 by Dan Heller <argv@sun.com>.
  70 .SH AUTHOR
  71 Dan Heller <argv@sun.com>, 1985.
  72
  73 Ability to run standalone or with \fIxscreensaver\fP added by
  74 Jamie Zawinski <jwz@jwz.org>, 13-aug-92.