summaryrefslogtreecommitdiff
path: root/stickynotes/docs/C/index.docbook
blob: 525f79466e069af3dcfa01b97ca2aa9262ec0de8 (plain)
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
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appletversion "2.12">
  <!ENTITY applet "Sticky Notes">
]>

<!-- (Do not remove this comment block.)
Maintained by the MATE Documentation Project
http://developer.mate.org/projects/gdp
Template version: 2.0 beta
Template last modified Mar 12, 2002
-->

<article id="index" lang="en">
<!-- please do not change the id; for translations, change lang to appropriate code -->
    
    <articleinfo> 
      <title>&applet; Manual</title> 
      <abstract role="description">
	<para>&applet; enables you to create, view, and manage 
          sticky notes on your desktop.</para>
      </abstract>

      <copyright>
        <year>2005</year>
	<holder>Davyd Madeley</holder>
      </copyright>
      <copyright>
        <year>2004</year>
        <holder>Shaun McCance</holder>
      </copyright>
      <copyright>
        <year>2004</year>
        <holder>Angela Boyle</holder>
      </copyright>
      <copyright> 
        <year>2003</year>  
        <year>2004</year>  
        <holder>Sun Microsystems</holder> 
      </copyright> 
      <copyright> 
        <year>2003</year>  
        <holder>Loban A Rahman</holder> 
      </copyright> 

	<!-- Translators: uncomment this:
	<copyright>
	    <year>2002</year>
	    <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
	</copyright>
	-->

	<publisher role="maintainer"> 
	    <publishername>MATE Documentation Project</publishername> 
	</publisher> 
	
	&legal;

	<authorgroup>
          <author>
            <firstname>Shaun</firstname>
            <surname>McCance</surname>
            <affiliation>
              <orgname>MATE Documentation Project</orgname>
	      <address><email>shaunm@gnome.org</email></address>
            </affiliation>
          </author>
          <author>
            <firstname>Angela</firstname>
            <surname>Boyle</surname>
	    <affiliation>
             <address><email>aboyle@aboyle.com</email></address>
	    </affiliation>
          </author>
          <author> 
            <firstname>Loban</firstname> 
            <surname>Rahman</surname> 
	    <affiliation>
             <address><email>loban@earthling.net</email></address>
	    </affiliation>
          </author>
	  <author>
	    <firstname>Davyd</firstname><surname>Madeley</surname>
	    <affiliation>
	     <orgname>MATE Project</orgname>
	     <address><email>davyd@madeley.id.au</email></address>
	    </affiliation>
	  </author>

	    <!-- This is appropriate place for other contributors: translators, maintainers, etc. Commented out by default.
	    <othercredit role="translator">
		<firstname>Latin</firstname> 
		<surname>Translator 1</surname> 
		<affiliation> 
		    <orgname>Latin Translation Team</orgname> 
		    <address> <email>translator@gnome.org</email> </address> 
		</affiliation>
		<contrib>Latin translation</contrib>
	    </othercredit>
	    -->
	</authorgroup>
	
	<releaseinfo revision="2.26" role="review"/>

	<revhistory>
	    <revision>
	      <revnumber>Version 2.12</revnumber>
	      <date>September 2005</date>
	      <revdescription>
	       <para role="author">Davyd Madeley</para>
	      </revdescription>
	    </revision>
	    <revision>
	      <revnumber>Version 2.10</revnumber>
	      <date>March 2005</date>
	      <revdescription>
	       <para role="author">Davyd Madeley</para>
	      </revdescription>
	    </revision>
	    <revision>
		<revnumber>Version 2.8</revnumber> 
		<date>September 2004</date> 
		<revdescription> 
                    <para role="author">Angela Boyle</para>
                    <para role="publisher">MATE Documentation Project</para>
		</revdescription> 
	    </revision>
	    <revision>
		<revnumber>&applet; Applet Manual V2.3</revnumber> 
		<date>February 2004</date> 
		<revdescription> 
                    <para role="author">Sun GNOME Documentation Team</para>
                    <para role="publisher">MATE Documentation Project</para>
		</revdescription> 
	    </revision>
	    <revision> 
		<revnumber>&applet; Applet Manual V2.2</revnumber> 
		<date>November 2003</date> 
		<revdescription>
                    <para role="author">Sun GNOME Documentation Team</para>
                    <para role="publisher">MATE Documentation Project</para>
		</revdescription> 
	    </revision>
	    <revision> 
		<revnumber>&applet; Applet Manual V2.1</revnumber> 
		<date>August 2003</date> 
		<revdescription> 
                    <para role="author">Sun GNOME Documentation Team</para>
                    <para role="publisher">MATE Documentation Project</para>
		</revdescription> 
	    </revision>
	    <revision> 
		<revnumber>&applet; Applet Manual V2.0</revnumber> 
		<date>May 2003</date> 
		<revdescription> 
		    <para role="author">Loban A Rahman
			<email>loban@earthling.net</email></para> 
		    <para role="publisher"></para> 
		</revdescription> 
	    </revision>
	</revhistory> 
	
	<releaseinfo>This manual describes version &appletversion; of &applet;.</releaseinfo> 
	
	<legalnotice>
	    <title>Feedback</title>
	    <para>To report a bug or make a suggestion regarding the
	    <application>&applet;</application> application or this manual, follow the directions in the <ulink url="help:mate-feedback" type="help">MATE Feedback Page</ulink>. </para>
	</legalnotice>
    </articleinfo> 
    
    <indexterm> 
	<primary>Sticky Notes</primary> 
    </indexterm> 

<sect1 id="stickynotes-introduction">
  <title>Introduction</title>
  <figure id="stickynotes-fig">
    <title>&applet;</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/stickynotes_applet.png" format="PNG"/>
        </imageobject>
        <textobject><phrase>Shows Sticky Notes</phrase></textobject>
      </mediaobject>
    </screenshot>
  </figure>

  <para>The <application>&applet;</application> panel application enables you
  to create,
  view, and manage sticky notes on your desktop. You can edit the title,
  contents, dimensions, and style of sticky notes. When the panel is
  restarted, for example when you log out and log in again, all sticky
  notes are saved and reopened in the same position with the same
  dimensions and style.</para>

  <para>To add <application>&applet;</application> to a panel,
  right-click on the panel, then choose <guimenuitem>Add to
  Panel</guimenuitem>.  Select <application>&applet;</application>
  in the <application>Add to the panel</application> dialog, then
  click <guibutton>OK</guibutton>.</para>
</sect1>
    
<sect1 id="stickynotes-usage"> 
  <title>Using Sticky Notes</title>

  <sect2 id="stickynotes-show-hide">
   <title>Showing and Hiding Sticky Notes</title>
   <para>
    To hide all your notes, either click on the desktop, or right-click the <application>&applet;</application> applet and choose <guimenuitem>Hide Notes</guimenuitem>.</para>
    <para>To show all your notes, click the <application>&applet;</application> applet.</para>
  </sect2>

  <sect2 id="stickynotes-create-note">
    <title>Creating a Sticky Note</title>
  <figure id="stickynotes-using-right-new-fig">
    <title>creating a new sticky note</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/stickynote-right-menu-new.png" format="PNG"/>
        </imageobject>
        <textobject><phrase>creating a new sticky note</phrase></textobject>
      </mediaobject>
    </screenshot>
   </figure>
    <para>You can create a sticky note by right-clicking on the sticky note icon and
    selecting <guilabel>New Note</guilabel>, or by double-clicking the applet.</para>
    <para>Creating a note causes all hidden notes to be shown.</para>
  </sect2>

  <sect2 id="stickynotes-lock-notes">
    <title>Locking and Unlocking Sticky Notes</title>
    <para>You can lock or unlock all sticky notes at the same time, or you can
    lock or unlock individual sticky notes.  Locking a sticky note prevents you
    from accidentally changing the contents of the note.</para>
    <variablelist>
      <varlistentry>
        <term><phrase>To Lock or Unlock All Sticky Notes</phrase></term>
        <listitem>
  <figure id="stickynotes-using-right-lock-fig">
    <title>Right Clicking on the Icon</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/stickynote-right-menu-lock.png" format="PNG"/>
        </imageobject>
        <textobject><phrase>Right Clicking on the Icon</phrase></textobject>
      </mediaobject>
    </screenshot>
  </figure>
          <para>To lock all sticky notes so that the notes cannot be edited,
          choose <guimenuitem>Lock Notes</guimenuitem> from the icon
          right-click menu so that there is a check mark next to it.  To
          unlock all sticky notes, choose <guimenuitem>Lock Notes</guimenuitem>
          from the icon right-click menu again so that there is not a check
          mark next to it.</para>
          <para>Note that all panel applications have the
	  <guimenuitem>Lock to Panel</guimenuitem>
          item in the right-click menu, which locks the position of the panel
	  application
          on the panel.  Do not confuse this with the
          <guimenuitem>Lock Notes</guimenuitem> item.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><phrase>To Lock or Unlock Individual Sticky Notes</phrase></term>
        <listitem><para>To lock an individual sticky note, right-click on the
        title of the note, then choose <guimenuitem>Lock Note</guimenuitem>
        from the popup menu.  To unlock an individual note, right-click on the
        title of the note, then choose <guimenuitem>Lock Note</guimenuitem>
        from the popup menu again. You can also toggle the lock/unlock state of
	a sticky note by clicking the lock button in the top left corner of the
	sticky note.
	</para></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="stickynotes-delete-notes">
    <title>Deleting Sticky Notes</title>
    <para>You can delete all sticky notes at the same time, or you can delete
    individual sticky notes.</para>
    <variablelist>
      <varlistentry>
        <term>To Delete All Sticky Notes</term>
        <listitem><para>To delete all sticky notes, choose <guimenuitem>Delete
        Notes</guimenuitem> from the icon right-click menu.  A confirmation
        dialog will appear; click on the <guibutton>Delete All</guibutton>
        button to confirm the deletion.</para></listitem>
      </varlistentry>
      <varlistentry>
        <term>To Delete Individual Sticky Notes</term>
        <listitem><para>To delete an individual sticky note, right-click on the
        title of the note, then choose <guimenuitem>Delete Note</guimenuitem>
        from the popup menu. You can also delete a sticky note by clicking the
	<guibutton>x</guibutton> in the top right corner.
	</para></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

</sect1>

<sect1 id="stickynotes-advanced-settings"> 
  <title>Preferences</title>
  
  <figure id="stickynotes-prefs-fig">
    <title>&applet; Preferences</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/stickynotes-prefs.png" format="PNG"/>
        </imageobject>
        <textobject><phrase>Shows Sticky Notes preferences</phrase></textobject>
      </mediaobject>
    </screenshot>
  </figure>

  <sect2 id="stickynotes-size">
    <title>Adjusting Size</title> 
    <para>To configure the default size for all sticky notes, right-click on the
    sticky notes icon, then choose <guimenu>Preferences</guimenu> from the popup menu. The
    <application>Sticky Notes Preferences</application> dialog is displayed.</para>
    <variablelist> 
      <varlistentry> 
        <term><guilabel>Width</guilabel></term> 
        <listitem><para>Use this spin box to specify the default width of new
        sticky notes, in pixels.</para></listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Height</guilabel></term> 
        <listitem><para>Use this spin box to specify the default height of new
        sticky notes, in pixels.</para></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="stickynotes-color">
    <title>Changing Color and Font</title>
    <para>To configure the color and font for all sticky notes, right-click on
    the icon, then choose <guimenu>Preferences</guimenu> from the popup menu.
    The <application>Sticky Notes Preferences</application> dialog is
    displayed.</para>
    <variablelist>
      <varlistentry>
        <term><guilabel>Font Color</guilabel></term>
	<listitem>
	 <para>
	  Click on the color selector button to display the color selector
	  dialog. On the color selector dialog, use the color wheel or spin
	  boxes to choose the default font color for stickynotes.
	 </para>
	 <para>
	  If you have selected, <guilabel>Use color from the system
	  theme</guilabel>, then the current theme colors will be used and you
	  will not be able to select new defaults.
	 </para>
	</listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Note Color</guilabel></term> 
        <listitem>
          <para>Click on the color selector button to display the color
          selector dialog. On the color selector dialog, use the color wheel or
          spin boxes to choose the default base color for sticky notes.</para>
          <para>If you have selected, <guilabel>Use color from the system
	  theme</guilabel>, then the current theme colors will be used and you
	  will not able to select new defaults.
	  </para>
        </listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Font</guilabel></term> 
        <listitem>
          <para>Click on the font selector button to display the font selector
          dialog. On the font selector dialog, use the list boxes to choose the
          default font for sticky notes.</para>
	  <para>
	   If you have selected, <guilabel>Use font from the system
	   theme</guilabel>, then the current Application Font set in <!--
	   FIXME: can I cross reference preferences? -->Font Preferences will be
	   used and you will not be able to select new defaults.
	  </para>
        </listitem>
      </varlistentry>
    </variablelist> 
  </sect2>
  <sect2 id="stickynotes-behavior">
    <title>Customizing Behavior</title>
    <para>To customize the behavior of <application>&applet;</application>,
    right-click on the icon, then choose <guimenu>Preferences</guimenu>
    from the popup menu.  The <application>Sticky Notes Preferences</application>
    dialog is displayed.</para>
    <para>To specify that sticky notes are visible on all workspaces on the
    desktop, select <guilabel>Put notes on all workspaces</guilabel> in the
    <guilabel>Sticky Notes Preferences</guilabel> dialog.  If you are using
    multiple workspaces, this will cause all sticky notes to be visible on
    all workspaces.</para>

    <para>
     The option, <guilabel>Force default color and font on notes</guilabel>,
     will force all sticky notes on your desktop to use the color and font
     settings specified in the <guilabel>Default Note Properties</guilabel>
     above (see <xref linkend="stickynotes-color"/>).
    </para>
  </sect2>

  </sect1>

  <sect1 id="stickynotes-settings-individual"> 
    <title>Customizing Individual Notes</title>
  <figure id="stickynotes-note-prefs-fig">
    <title>Sticky Note Preferences</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/stickynotes-note-prefs.png" format="PNG"/>
        </imageobject>
        <textobject><phrase>a Sticky Note's preferences</phrase></textobject>
      </mediaobject>
    </screenshot>
  </figure>
    <para>You can customize the look of each individual sticky note.  This
    can be useful for visually distinguishing different types of notes
    quickly.  To configure the settings for an individual sticky note,
    right-click on the note's title, then choose <guimenu>Properties</guimenu>
    from the popup menu.  The <application>Sticky Note Properties</application>
    dialog is displayed.</para>
    <variablelist> 
      <varlistentry> 
        <term><guilabel>Title</guilabel></term> 
        <listitem><para>Use this text box to specify the title of the sticky
        note.</para></listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Use default color</guilabel></term> 
        <listitem><para>Select this option to use the default base color for
        this sticky note.  For information on setting the default base color,
        see <xref linkend="stickynotes-color"/>.</para></listitem>
      </varlistentry>
      <varlistentry>
       <term><guilabel>Font Color</guilabel></term>
       <listitem>
        <para>Click on the color selector button to display the color selector
	dialog. On the color selector dialog, use the color wheel or spin boxes
	to choose the font color for this sticky note.</para>
       </listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Note Color</guilabel></term> 
        <listitem><para>Click on the color selector button to display the
        color selector dialog. On the color selector dialog, use the color
        wheel or spin boxes to choose the base color for this sticky
        note.</para></listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Use default font</guilabel></term> 
        <listitem><para>Select this option to use the default font for this
        sticky note.  For information on setting the default font, see
        <xref linkend="stickynotes-color"/>.</para></listitem>
      </varlistentry>
      <varlistentry> 
        <term><guilabel>Font</guilabel></term> 
        <listitem><para>Click on the font selector button to display the font
        selector dialog.  On the font selector dialog, use the list boxes to
        choose the font for this sticky note.</para></listitem>
      </varlistentry>
    </variablelist> 
</sect1>
</article>