Return to xclock.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / X / man

Annotation of 43BSD/contrib/X/man/xclock.1, revision 1.1

1.1     ! root        1: .TH XCLOCK 1 "18 August 1985" "X Version 10"
        !             2: .SH NAME
        !             3: xclock - X Window System, analog / digital clock
        !             4: .SH SYNOPSIS
        !             5: .B xclock
        !             6: [ option ] ...
        !             7: .SH DESCRIPTION
        !             8: .I Xclock 
        !             9: is the
        !            10: .I X
        !            11: window system clock.
        !            12: .I Xclock
        !            13: Continuously  displays  the  current  time of day.  The user is given a
        !            14: choice of either an analog or a digital display (of  course  there  is
        !            15: nothing  precluding  the  user  from  having more than one clock).  It
        !            16: creates a window and displays the time in the chosen format.
        !            17: .SH ARGUMENTS
        !            18: .PP
        !            19: .TP 10
        !            20: .B \-analog 
        !            21: Use analog display mode.  Draw a conventional 12 hour clock face with ``ticks''
        !            22: for each minute and stroke marks on each hour.  The default is digital mode.
        !            23: .PP
        !            24: .TP 10
        !            25: .B \-bg \fIcolor\fP
        !            26: Determines the color of the background.
        !            27: .PP
        !            28: .TP 10
        !            29: .B \-bd \fIcolor\fP
        !            30: Determines the color of the border.
        !            31: .PP
        !            32: .TP 10
        !            33: .B \-bw \fIpixels\fP
        !            34: Specify the width in pixels of the border around the
        !            35: .I xclock
        !            36: window.
        !            37: .PP
        !            38: .TP 10
        !            39: .B \-digital
        !            40: Use  digital  display  mode  (default).   Display the date and time in
        !            41: digital format.
        !            42: .PP
        !            43: .TP 10
        !            44: .B \-fg \fIcolor\fP
        !            45: Determines the color of the text in digital mode and the
        !            46: tick marks in analog mode.
        !            47: .PP
        !            48: .TP 10
        !            49: .B \-fn \fIfont\fP
        !            50: The specified
        !            51: .I font
        !            52: will be used as the output font
        !            53: in digital mode. Any fixed width font may be used, the default is ``6x10''.
        !            54: .PP
        !            55: .TP 10
        !            56: .B \-help
        !            57: Display a brief summary of
        !            58: .I xclock's
        !            59: calling syntax and options.
        !            60: .PP
        !            61: .TP 10
        !            62: .B \-hl \fIcolor\fP
        !            63: Determines the color of the hands in analog mode.
        !            64: .PP
        !            65: .TP 10
        !            66: .B \-padding \fIpixels\fP
        !            67: Specify the width in pixels of the padding ``white space''
        !            68: between the window border and anything
        !            69: .I xclock
        !            70: displays.  The default padding is 10 in digital mode and 8 in analog mode.
        !            71: .PP
        !            72: .TP 10
        !            73: .B \-rv
        !            74: Cause
        !            75: .I xclock
        !            76: to produce all output in white-on-black instead of black-on-white.  This
        !            77: is only useful on Black and White displays.
        !            78: .PP
        !            79: .TP 10
        !            80: .B \-update \fIseconds\fP
        !            81: Specify the frequency in seconds with which
        !            82: .I xclock
        !            83: updates its display.  If the
        !            84: .I xclock
        !            85: window is obscured and then exposed,
        !            86: .I xclock
        !            87: will override this setting  and  redisplay  immediately.   The  default
        !            88: update  frequency  is  60  seconds.   The  specification  of an update
        !            89: frequency greater than 30 seconds disables the display of  the  second
        !            90: hand in analog mode.
        !            91: .PP
        !            92: .TP 8
        !            93: .B =\fIgeometry\fP
        !            94: The clock window is created with the specified
        !            95: size according to the geometry specification.
        !            96: See \fIX(1)\fP for details.
        !            97: In digital mode if you do not specify either height and width they are
        !            98: determined  by  the font in use.  In analog mode if you do not specify
        !            99: either width or height they default to 164.  The  default  offset  for
        !           100: any unspecified offset is -0.  All values are in pixels.
        !           101: .PP
        !           102: .TP 10
        !           103: .B \fIhost\fP:\fIdisplay\fP
        !           104: Normally,
        !           105: .I xclock
        !           106: gets  the host and display number to use from the environment variable
        !           107: ``DISPLAY''.  One can, however specify them explicitly.
        !           108: The
        !           109: .I host
        !           110: specifies which machine to create the
        !           111: .I xclock
        !           112: window on, and
        !           113: the
        !           114: .I display
        !           115: argument specifies the display number.
        !           116: For example,
        !           117: ``mit-frobozz:1'' creates an
        !           118: .I xclock
        !           119: on display one on the machine mit-frobozz.  If the host is omitted the
        !           120: local  host  is  assumed.   If  the  display  is omitted, display 0 is
        !           121: assumed, the ``:'' is necessary in either case.
        !           122: .SH X DEFAULTS
        !           123: .PP
        !           124: .PP
        !           125: .TP 8
        !           126: .B Background
        !           127: To determine the background color.
        !           128: .PP
        !           129: .TP 8
        !           130: .B Border
        !           131: To determine the border color.
        !           132: .PP
        !           133: .TP 8
        !           134: .B BorderWidth
        !           135: To determine the border width.
        !           136: .PP
        !           137: .TP 8
        !           138: .B BodyFont
        !           139: To determine digital clock display font.
        !           140: .PP
        !           141: .TP 8
        !           142: .B Foreground
        !           143: To determine the foreground color.
        !           144: .PP
        !           145: .TP 8
        !           146: .B Highlight
        !           147: To determine the highlight color.
        !           148: .PP
        !           149: .TP 8
        !           150: .B InternalBorder
        !           151: To determine the internal padding value.
        !           152: .PP
        !           153: .TP 8
        !           154: .B Mode
        !           155: To determine if ``analog'' or ``digital'' mode is the default.
        !           156: .PP
        !           157: .TP 8
        !           158: .B ReverseVideo
        !           159: If ``on'', the clock should be white on black instead of black on white.
        !           160: This is only useful on Black and White displays.
        !           161: .PP
        !           162: .TP 8
        !           163: .B Update
        !           164: To determine the update rate.
        !           165: .SH ENVIRONMENT
        !           166: .PP
        !           167: .TP 8
        !           168: .B DISPLAY
        !           169: To get the default host and display number.
        !           170: .SH SEE ALSO
        !           171: X(1), xwm(1), X(1), time(3C), select(2)
        !           172: .SH AUTHORS
        !           173: .PP
        !           174: Copyright 1985, Massachusetts Institute of Technology.
        !           175: .PP
        !           176: Tony Della Fera (MIT-Athena, DEC)
        !           177: .PP
        !           178: Dave Mankins (MIT-Athena, BBN)
        !           179: .SH BUGS
        !           180: .I Xclock
        !           181: believes the Unix clock.  When specifying the window size manually  in
        !           182: digital  mode  the  string should be centered automatically, currently
        !           183: you have to fiddle with the padding parameter to get it right.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.