1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
|
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.76 [en] (X11; U; Linux 2.4.2-2 i686) [Netscape]">
<meta name="Author" content="M Craig">
<meta name="Description" content="User's guide for Goats">
<title>Goats help</title>
</head>
<body text="#000000" bgcolor="#ffffff" link="#0000ee" vlink="#551a8b" alink="#ff0000">
<h1> Goats</h1>
Copyright © 2000 by M.Craig
<p>Goats gives you post-it notes on your Gnome desktop! </p>
<h2> Contents</h2>
<a href="#compile">Compiling Goats</a>
<br>
<a href="#run">Running Goats</a>
<br>
<a href="#use">Using Goats</a>
<br>
<a href="#bugs">Known bugs and limitations</a>
<br>
<a href="#author">Author</a>
<br>
<a href="#license">License</a>
<h2> <a name="compile"></a>
Compiling Goats</h2>
From a source file, e.g. goats-0.6.tar.gz, type the following:
<p><tt>gunzip goats-0.6.tar.gz</tt> <br>
<tt>tar -xvf goats-0.6.tar</tt> </p>
<p>This uncompresses the source code and creates a directory <tt>goats-0.6
</tt>containing the source code. You can now delete the file <tt>goats-0.6.tar</tt>
. Enter the source directory using <tt>cd goats-0.6 </tt>and type: </p>
<p><tt>./configure</tt> <br>
<tt>make</tt> </p>
<p>This compiles the package. To install the package you must be root. Type:
</p>
<p><tt>make install</tt> </p>
<p>By default, Goats installs files in /usr/. This should be correct for most
Gnome installations. If you want Goats installed in /usr/local/ use <tt>./configure
--prefix=/usr/local </tt>in place of <tt>./configure </tt>in the above instructions.
</p>
<h4> Problems compiling</h4>
Old versions of gnome don't support different panel sizes. If you get an
error message about <tt>applet_widget_get_panel_pixel_size , </tt>type:
<p><tt>make clean</tt> <br>
<tt>./configure --disable-panel-size</tt> <br>
<tt>make</tt> </p>
<p>If you don't want to use the panel at all, you can compile the program
without support for it. Type: </p>
<p><tt>make clean</tt> <br>
<tt>./configure --disable-panel</tt> <br>
<tt>make</tt> </p>
<p>If you still can't get it to work, read the INSTALL file contained in the
distribution. </p>
<h2> <a name="run"></a>
Running Goats</h2>
You should be able to add Goats to the panel by right clicking on the panel
and selecting:
<p><tt>add applet->Utility->Goats</tt> </p>
<p>from the menu. If you can't find Goats in the menu, the file <tt>goats.desktop
</tt>has been installed in the wrong place. Try copying it to <tt>/usr/share/applets/Utility/
</tt>or <tt>/usr/local/share/applets/Utility/</tt> </p>
<p>You can also run goats from the command line -<tt> just type goats</tt>
</p>
<p>If the applet fails to appear, a common problem is the file <tt>goats.gnorba</tt>
. Normally it should be in the directory <tt>/etc/CORBA/servers/</tt> It
may have been put in <tt>/usr/etc/CORBA/servers/ </tt>or <tt>/usr/local/etc/CORBA/servers/</tt>
Find out where it is and try copying it to the other locations. </p>
<p>If you want to run Goats without the Gnome panel<tt>, type goats --without-panel.</tt>
</p>
<h2> <a name="use"></a>
Using Goats</h2>
Most of the options are fairly self explanatory. This is a brief description
of what you can do with Goats.
<h4> The Applet</h4>
<img src="applet.jpg">
<br>
<br>
Click with the left button to get a new goat with default settings. Click
with the right button for the following options: <br>
<ul>
<li> <b>About - </b>Shows a little information about the program</li>
<li> <b>Help</b> - Displays this file...</li>
<li> <b><a href="#preferences">Preferences</a>
- </b>Change default settings for goats</li>
<li> <b>My Goats - </b>Gives a menu of things you can do to your herd of
goats:</li>
<ul>
<li><b>Show Summary - </b>Show a summary of all your goats. Left click
on a row to select a goat, and right click for a menu to raise, hide, delete,
cancel alarms etc.<br>
</li>
</ul>
<ul>
<li> <b>Raise all - </b>Bring all your goats to the front of the desktop.</li>
<li> <b>Lower all - </b>Send all your goats to the back of the desktop.</li>
<li> <b>Show all</b> - Makes any hidden goats reappear.</li>
<li> <b>Hide all - </b>Makes all the goats disappear, but doesn't delete
them.</li>
<li> <b>Shade all</b> - Hide the text boxes, leaving just the title bar.</li>
<li> <b>Unshade all -</b> Show any hidden text boxes.</li>
<li> <b>Delete all - </b>Delete all your goats permanently.</li>
</ul>
</ul>
<h4> <a name="preferences"></a>
Preferences</h4>
<h5> <img src="preferences.jpg">
</h5>
<blockquote><b>Defaults:</b></blockquote>
<ul>
<li> <b>Default size</b> - Changes the default size of goats in pixels.</li>
<li> <b>Default colour</b> - Choice of three colours or random. Click
the 'Customize' button to change the colours offered..</li>
<li> <b>Default font</b> - The default font for goats. Note that calendars
are not displayed correctly unless you use a fixed width font.</li>
<li> <b>Default alarm sound</b> - If you want your alarms to play a sound
by default, click this button and select the sound file you want to play.</li>
<li> <b>Sticky by default - </b>If selected, new goats are sticky (appear
on every desktop).</li>
<li> <b>Floating by default - </b>If selected, new goats float above
other windows.</li>
<li> <b>Text colour</b> - The colour of the text on the goats, click
on the button to change it.</li>
<p><br>
<b>Options:</b> <br>
</p>
<li> <b>Raise note...</b> - <b>When dragbar is clicked</b> means the
goat will behave like a normal window, and clicking on the dragbar at the
top brings it to the front. <b>Only when button is held</b> means that once
the goat has been lowered to the bottom, it only comes forward when you hold
the button down - when you release the button it snaps back to the bottom.</li>
<li> <b>When popping up note</b> - You can choose to be notified of an
alarm by popping up the note you set it on. The note can either just come
to the front on whatever desktop you left it on, or it can jump to your current
desktop. Here you can select which you prefer.</li>
<li> <b>When setting alarm...</b> - Select if you prefer the 24 hr clock
in your alarm dialog.</li>
<li> <b>Delete button - </b>The button at the top right of a goat can
be made to delete or hide the goat. The icon will change from a cross (delete)
to a something-disappearing (hide)</li>
<li> <b>Autosave goats on focus out </b>- if selected, whenever you alter
a goat and then move the pointer away from it your goats will be saved. This
may be useful if you experience frequent crashes, but should not be necessary
otherwise.</li>
</ul>
<ul>
<b>Helpers:</b> <br>
<li> <b>Print command</b> - Command executed by the 'Print text' option.
%s is replaced by the title of the goat. This command acts on a file containing
the text of the goat. The default command is 'a2ps', a utility for printing
text to a PostScript printer available from <a href="ftp://ftp.enst.fr/pub/unix/a2ps/">
ftp://ftp.enst.fr/pub/unix/a2ps/.</a>
</li>
<li> <b>Mail command</b> - Command executed by the 'Mail text' option.
This command takes the text from standard input. The first %s is replaced
by the subject of the mail, the second is the address.</li>
<li> <b>Other programs</b> - if ticked, other programs can create notes
by altering the file <tt>~/,gnome/goats_new</tt>. This option exists because
a friend of mine was generating a REX synchronisation package that wanted
to create notes from its 'memo' feature. It is possible (unlikely though)
that someone else may take advantage of this as well. If you are a programmer
and want to do this <a href="goats_new.html">here is some information</a>
. Otherwise it doesn't make much difference.</li>
</ul>
<h4> The Goat</h4>
Click with the left button in the text area to start typing. Click with the
left on the title bar to raise the note, and to drag it around. Click
with the left button on the resize icon (top left) and drag to resize the
note (it will remain square). Click on the cross to delete/hide the goat
(see <a href="#preferences">preferences</a>
). Double click in the title bar to change the title. Middle click in the
title bar to shade/unshade the note . Click anywhere with the right button
to get a menu.
<h4> The Menu.</h4>
<ul>
<li> <b>New goat - </b>Creates a new default goat. Same as clicking on
the panel applet.</li>
<li> <b>Text... - Fit size </b>makes your goat just the right size to
fit the text you've typed. <b>Clear </b>just deletes the text . <b>Print</b>
prints the text of the note to a printer, <b>Mail</b> sends it as an email.
(See <a href="#preferences">preferences</a>
). <b>IP Message </b>lets you send the text as an instant message using the
"IP messanger" program (see <a href="http://gipmsg.sourceforge.net/#intro">
http://gipmsg.sourceforge.net/#intro</a>
)</li>
<li> <b>Set... Title </b>gives your note a title which is displayed in
the top bar. You can also set the title by double clicking in the title bar.
<b>Alarm</b> allows you to set an alarm for the goat, or view the currently
set alarm.</li>
<li> <b>Insert...</b> - Inserts the current time and date, a calendar,
or a random piece of wisdom into your goat.</li>
<li> <b>Properties</b> - <b>Colour</b> lets you change the colour of
the note, <b>Font </b>changes the font the text is displayed in, <b>Sticky</b>
means the note always appears no matter what desktop you are on. <b>Floating</b>
means the goat is always in front of the other windows. <b>Shaded</b> means
the text box is hidden leaving only the title bar. You can also shade a goat
be clicking in the title bar with the middle button.</li>
<li> <b>Raise - </b>Brings the goat to the front of all the other windows.</li>
<li> <b>Lower - </b>Puts the goat behind all the other windows.</li>
<li> <b>Hide</b> - makes the goat disappear without deleting it. You
can make it visible by selecting <b>show all</b> from the <a href="#use">
applet menu</a>
</li>
<li> <b>Delete - </b>Permanently delete the goat.</li>
</ul>
<h4> <a name="alarm"></a>
Set an alarm</h4>
<img src="set_alarm.jpg">
<ul>
<li> <b>Alarm on</b> - toggles whether the alarm is on or not.</li>
<li> <b>Remind me at...</b> - Select the date and time you want the alarm
to go off. If you want the alarm to repeat at fixed intervals, select the
repeat from the menu to the right of the time selector.</li>
<li> <b>Display a message - </b>Pops up a message box containing the
given message when the alarm goes off.</li>
<li> <b>Pop up the note</b> - The note itself comes to the front when
the alarm goes off (see <a href="#preferences">preferences</a>
).</li>
<li> <b>Play sound</b> - Selects whether to play a sound when the alarm
goes off. You can type the sound file you want played in the text entry,
or click on <b>select file</b> to choose a sound. The default is a goat's
bleat...</li>
</ul>
<h4> Saving goats</h4>
Goats are automatically saved when you logout, remove the applet from the
panel, or kill it using the <tt>kill </tt>command. You don't need to save
them manually.
<h2> <a name="bugs"></a>
Known Bugs and Limitations</h2>
Notes that aren't moved from their initial position are saved at co-ords
0,0. This is because gdk_window_get_origin doesn't seem to work....
<p>Saved notes don't pop up on their original desktop. This is because I
don't know how to get/set the desktop. </p>
<p>Memory leak when creating the set alarm dialog. I think this is a problem
with the gnome_date_edit widget. </p>
<p>Some problems with raise/lower not working which causes problems when
dragging & resizing. </p>
<h2> <a name="author"></a>
Author</h2>
M.Craig <a href="mailto:martin@menudo.freeserve.co.uk"><martin@menudo.freeserve.co.uk></a>
<br>
Goats home page: <a href="http://www.menudo.freeserve.co.uk/goats.html">http://www.menudo.freeserve.co.uk/goats.html</a>
<h2> <a name="license"></a>
License</h2>
This program is free software; you can redistribute it and/or modify it under
the terms of the <i>GNU General Public License</i> as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.
<p>This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the <i>GNU General Public License</i> for more
details. </p>
<p>A copy of the <i>GNU General Public License</i> is included as an appendix
to the <i>GNOME Users Guide</i>. You may also obtain a copy of the <i>GNU
General Public License</i> from the Free Software Foundation by visiting <a href="http://www.fsf.org" target="_top">
their Web site</a>
or by writing to </p>
<p class="ADDRESS">Free Software Foundation, Inc. <br>
<span class="STREET">59 Temple Place</span> - Suite 330 <br>
<span class="CITY">Boston</span>, <span class="STATE">MA</span><span class="POSTCODE">
02111-1307</span> <br>
<span class="COUNTRY">USA</span> <br>
<br>
</p>
</body>
</html>
|
