SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE




YUM REPOSITORY

 
 

MAN page from Mandriva 2010 xcowsay-1.2-2mdv2010.1.i586.rpm

xcowsay

Section: Games and Demos (6)
Index 

NAME

xcowsay - Display a cute cow and speech bubble. 

SYNOPSIS

xcowsay[-h][-ttime][-rspeed][-d][-ffont][text]...

 

DESCRIPTION

Display a cow with a speech bubble containing some text. If textis specified it will be displayed in the bubble. Otherwise the textwill be read from the standard input and displayed when end of fileis encountered.

The cow is displayed for either a fixed amount of time, or an amountof time calculated from the size of the text. Click on the cow todismiss it immediately.

If xcowsayis started with--daemonit will fork away from the terminal and run in daemon mode. The daemon provides a DBus service uk.me.doof.Cowsay that responds toShowCow requests. The daemon can queue up any number of requests and displaysthem in order.

Whenxcowsaystarts it checks to see if a daemon is running, and if it is, sends aShowCowrequest and returns immediately. Otherwise xcowsaywill block until the cow has disappeared.

 

CONFIGURATION FILE

xcowsay reads a configuration file on startup. The configuration filecan be stored in the XDG compliant location $XDG_CONFIG_HOME/xcowsayrc(which will default to$HOME/.config/xcowsayrc)or in your home directory at$HOME/.xcowsayrc.If the --config=FILEcommand line option is passed FILEwill be processed after your personal configuration file.

The configuration file consists of 'option = value' pairs, one per line. Thevalid keys are given in the next section. For example, the following line setsdisplay time to 10 seconds:

display_time = 10000

The character '#' begins a comment which lasts until the end of the line.

 

OPTIONS

Note that these options override any settings in the config file.
-h, --help
Display usage information.
-t time, --time=time
Display the cow fortimeseconds. This overrides any value set forreading_speed.The corresponding config file option isdisplay_time.
-r speed, --reading-speed=speed
Number of milliseconds to display the cow for each word in the inputtext. This is clamped to a minimum ofmin_display_timeand a maximum ofmax_display_time.The defaults are 1 second and 30 seconds respectively. The correspondingconfig file option isreading_speed.
-f font, --font=font
Font for the speech bubble text. Accepts Pango font strings. Thecorresponding config file option isfont.
-d file, --dream=file
Display an image instead of text in the cow's bubble. Thedream_time config file option sets the numer of milliseconds to display theimage for. The default is 10 seconds.
--think
Display a thought bubble instead of a speech bubble.
--daemon
Run xcowsay in daemon mode if DBus support has been enabled. See thedescription for more information.
--cow-size=size
Size of the cow image. Current choices are small, med, or large.The corresponding config file option iscow_size.
--image=file
Use a different image instead of the cow. The corresponding config fileoption isalt_image.
--monitor=N
Make the cow appear on monitor N.
--at=X,Y
Force that cow to appear at screen location (X,Y). The config file optionsareat_xand at_y.
--bubble-at=X,Y
Change position of bubble relative to where it would normally appear. Thisis most useful when combined with the alt_imageoption to create your own characters. The config file options arebubble_x and bubble_y.
--debug
Print messages about whatxcowsayis doing. Useful for finding out why the daemon fails.
-v, --version
Print version information.
 

AUTHOR

Written by Nick Gasson. 

REPORTING BUGS

Report all bugs to nickAATTnickg.me.ukThexcowsayhomepageis<http://www.doof.me.uk/xcowsay> 

SEE ALSO

cowsay(6) 

BUGS

There are a few issues I am aware of:

The cow and speech bubble have jagged edges which would be improved byanti-aliasing.

Very long strings will disappear off the right-hand side of thescreen. This could be fixed e.g. by using Pango's word wrapping.


 

Index

NAME
SYNOPSIS
DESCRIPTION
CONFIGURATION FILE
OPTIONS
AUTHOR
REPORTING BUGS
SEE ALSO
BUGS

This document was created byman2html,using the manual pages.