Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 169 lines (168 sloc) 4.69 kb
37ab00b9 »
2010-03-10 initial import from tarball off http://www.nog.net/~tony/warez/cowsay…
1 .\"
2 .\" cowsay.1
3 .\"
4 .\" $Id: cowsay.1,v 1.4 1999/11/04 19:50:40 tony Exp $
5 .\"
6 .\" This file is part of cowsay. (c) 1999 Tony Monroe.
7 .\"
8 .ds Nm Cowsay
9 .ds nm cowsay
10 .ds Vn 3.02
11 .TH \*(nm 1 "$Date: 1999/11/04 19:50:40 $"
12 .SH NAME
13 \*(nm/cowthink \- configurable speaking/thinking cow (and a bit more)
14 .SH SYNOPSIS
15 cowsay
16 .RB [ \-e
17 .IR eye_string ]
18 .RB [ \-f
19 .IR cowfile ]
20 .RB [ \-h ]
21 .RB [ \-l ]
22 .RB [ \-n ]
23 .RB [ \-T
24 .IR tongue_string ]
25 .RB [ \-W
26 .IR column ]
27 .RB [ \-bdgpstwy ]
28 .SH DESCRIPTION
29 .I Cowsay
30 generates an ASCII picture of a cow saying something provided by the
31 user. If run with no arguments, it accepts standard input, word-wraps
32 the message given at about 40 columns, and prints the cow saying the
33 given message on standard output.
34 .PP
35 To aid in the use of arbitrary messages with arbitrary whitespace,
36 use the
37 .B \-n
38 option. If it is specified, the given message will not be
39 word-wrapped. This is possibly useful if you want to make the cow
40 think or speak in figlet(6). If
41 .B \-n
42 is specified, there must not be any command-line arguments left
43 after all the switches have been processed.
44 .PP
45 The
46 .B \-W
47 specifies roughly (where the message should be wrapped. The default
48 is equivalent to
49 .B \-W 40
50 i.e. wrap words at or before the 40th column.
51 .PP
52 If any command-line arguments are left over after all switches have
53 been processed, they become the cow's message. The program will not
54 accept standard input for a message in this case.
55 .PP
56 There are several provided modes which change the appearance of the
57 cow depending on its particular emotional/physical state. The
58 .B \-b
59 option initiates Borg mode;
60 .B \-d
61 causes the cow to appear dead;
62 .B \-g
63 invokes greedy mode;
64 .B \-p
65 causes a state of paranoia to come over the cow;
66 .B \-s
67 makes the cow appear thoroughly stoned;
68 .B \-t
69 yields a tired cow;
70 .B \-w
71 is somewhat the opposite of
72 .BR \-t ,
73 and initiates wired mode;
74 .B \-y
75 brings on the cow's youthful appearance.
76 .PP
77 The user may specify the
78 .B \-e
79 option to select the appearance of the cow's eyes, in which case
80 the first two characters of the argument string
81 .I eye_string
82 will be used. The default eyes are 'oo'. The tongue is similarly
83 configurable through
84 .B \-T
85 and
86 .IR tongue_string ;
87 it must be two characters and does not appear by default. However,
88 it does appear in the 'dead' and 'stoned' modes. Any configuration
89 done by
90 .B \-e
91 and
92 .B \-T
93 will be lost if one of the provided modes is used.
94 .PP
95 The
96 .B \-f
97 option specifies a particular cow picture file (``cowfile'') to
98 use. If the cowfile spec contains '/' then it will be interpreted
99 as a path relative to the current directory. Otherwise, cowsay
100 will search the path specified in the
101 .B COWPATH
102 environment variable.
103 To list all cowfiles on the current
104 .BR COWPATH ,
105 invoke
106 .B \*(nm
107 with the
108 .B \-l
109 switch.
110 .PP
111 If the program is invoked as
112 .B cowthink
113 then the cow will think its message instead of saying it.
114 .PP
115 .SH COWFILE FORMAT
116 A cowfile is made up of a simple block of
117 .BR perl (1)
118 code, which assigns a picture of a cow to the variable
119 .BR $the_cow .
120 Should you wish to customize the eyes or the tongue of the cow,
121 then the variables
122 .B $eyes
123 and
124 .B $tongue
125 may be used. The trail leading up to the cow's message balloon is
126 composed of the character(s) in the
127 .B $thoughts
128 variable. Any backslashes must be reduplicated to prevent
129 interpolation. The name of a cowfile should end with
130 .BR .cow ,
131 otherwise it is assumed not to be a cowfile. Also, at-signs (``@'')
132 must be backslashed because that is what Perl 5 expects.
133 .PP
134 .SH COMPATIBILITY WITH OLDER VERSIONS
135 .PP
136 What older versions? :-)
137 .PP
138 Version 3.x is fully backward-compatible with 2.x versions. If
139 you're still using a 1.x version, consider upgrading. And tell me
140 where you got the older versions, since I didn't exactly put them
141 up for world-wide access.
142 .PP
143 Oh, just so you know, this manual page documents version \*(Vn of
144 cowsay.
145 .SH ENVIRONMENT
146 The COWPATH environment variable, if present, will be used to search
147 for cowfiles. It contains a colon-separated list of directories,
148 much like
149 .B PATH or
150 .BR MANPATH .
151 It should always contain the
152 .B /usr/local/share/cows
153 directory, or at least a directory with a file called
154 .B default.cow
155 in it.
156 .SH FILES
157 .B %PREFIX%/share/cows
158 holds a sample set of cowfiles. If your
159 .B COWPATH
160 is not explicitly set, it automatically contains this directory.
161 .SH BUGS
162 If there are any, please notify the author at the address below.
163 .SH AUTHOR
164 Tony Monroe (tony@nog.net), with suggestions from Shannon
165 Appel (appel@CSUA.Berkeley.EDU) and contributions from Anthony Polito
166 (aspolito@CSUA.Berkeley.EDU).
167 .SH SEE ALSO
168 perl(1), wall(1), nwrite(1), figlet(6)
Something went wrong with that request. Please try again.