~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/programs/oclock/oclock.man

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" $Xorg: oclock.man,v 1.4 2001/02/09 02:05:33 xorgcvs Exp $
 
2
.\" Copyright 1989, 1998  The Open Group
 
3
.\" 
 
4
.\" Permission to use, copy, modify, distribute, and sell this software and its
 
5
.\" documentation for any purpose is hereby granted without fee, provided that
 
6
.\" the above copyright notice appear in all copies and that both that
 
7
.\" copyright notice and this permission notice appear in supporting
 
8
.\" documentation.
 
9
.\" 
 
10
.\" The above copyright notice and this permission notice shall be included
 
11
.\" in all copies or substantial portions of the Software.
 
12
.\" 
 
13
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 
14
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 
15
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 
16
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
 
17
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 
18
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 
19
.\" OTHER DEALINGS IN THE SOFTWARE.
 
20
.\" 
 
21
.\" Except as contained in this notice, the name of The Open Group shall
 
22
.\" not be used in advertising or otherwise to promote the sale, use or
 
23
.\" other dealings in this Software without prior written authorization
 
24
.\" from The Open Group.
 
25
.\"
 
26
.\" $XFree86: xc/programs/oclock/oclock.man,v 1.9 2002/10/12 16:06:45 herrb Exp $
 
27
.\"
 
28
.TH OCLOCK 1 __xorgversion__
 
29
.SH NAME
 
30
oclock \- round X clock
 
31
.SH SYNOPSIS
 
32
.B oclock
 
33
[\-option ... ]
 
34
.SH DESCRIPTION
 
35
.I Oclock
 
36
simply displays the current time on an analog display.
 
37
.SH OPTIONS
 
38
.TP 8
 
39
.B \-fg \fIcolor\fB
 
40
choose a different color for the both hands and the jewel of the clock
 
41
.TP 8
 
42
.B \-bg \fIcolor\fB
 
43
choose a different color for the background.
 
44
.TP 8
 
45
.B \-jewel \fIcolor\fB
 
46
choose a different color for the jewel on the clock.
 
47
.TP 8
 
48
.B \-minute \fIcolor\fB
 
49
choose a different color for the minute hand of the clock.
 
50
.TP 8
 
51
.B \-hour \fIcolor\fB
 
52
choose a different color for the hour hand of the clock.
 
53
.TP 8
 
54
.B \-backing \fI{ WhenMapped Always NotUseful }\fB
 
55
selects an appropriate level of backing store.
 
56
.TP 8
 
57
.B \-geometry \fIgeometry\fB
 
58
define the initial window geometry; see \fIX(__miscmansuffix__)\fP.
 
59
.TP 8
 
60
.B \-display \fIdisplay\fB
 
61
specify the display to use; see \fIX(__miscmansuffix__)\fP.
 
62
.TP 8
 
63
.B \-bd \fIcolor\fB
 
64
choose a different color for the window border.
 
65
.TP 8
 
66
.B \-bw \fIwidth\fB
 
67
choose a different width for the window border.  As the Clock widget changes
 
68
its border around quite a bit, this is most usefully set to zero.
 
69
.TP 8
 
70
.B \-shape
 
71
causes the clock to use the Shape extension to create an oval window.
 
72
This is the default unless the shapeWindow resource is set to false.
 
73
.TP 8
 
74
.B \-noshape
 
75
causes the clock to not reshape itself and ancestors to exactly
 
76
fit the outline of the clock.
 
77
.TP 8
 
78
.B \-transparent
 
79
causes the clock to consist only of the jewel, the hands, and the border.
 
80
.SH COLORS
 
81
If you would like your clock to be viewable in color, include the following 
 
82
in the #ifdef COLOR section you read with xrdb:
 
83
.sp 1
 
84
*customization:                 -color
 
85
.sp 1
 
86
.br
 
87
This will cause oclock to pick up the colors in the app-defaults color
 
88
customization file:
 
89
__projectroot__/lib/X11/app-defaults/Clock-color.
 
90
Below are the default colors:
 
91
.sp 1
 
92
Clock*Background: grey
 
93
.br
 
94
Clock*BorderColor: light blue
 
95
.br
 
96
Clock*hour: yellow
 
97
.br
 
98
Clock*jewel: yellow
 
99
.br
 
100
Clock*minute: yellow
 
101
.SH "SEE ALSO"
 
102
X(__miscmansuffix__), X Toolkit documentation
 
103
.SH AUTHOR
 
104
Keith Packard, MIT X Consortium