Return to xclock.0 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / man / man1

Annotation of 43BSDTahoe/new/X/man/man1/xclock.0, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: 
        !             4: XCLOCK(1)          UNIX Programmer's Manual            XCLOCK(1)
        !             5: 
        !             6: 
        !             7: 
        !             8: NAME
        !             9:      xclock - X Window System, analog / digital clock
        !            10: 
        !            11: SYNOPSIS
        !            12:      xclock [ option ] ...
        !            13: 
        !            14: DESCRIPTION
        !            15:      _X_c_l_o_c_k is the _X window system clock.  _X_c_l_o_c_k Continuously
        !            16:      displays  the  current  time of day.  The user is given a
        !            17:      choice of either an analog or a digital display (of  course
        !            18:      there  is nothing precluding  the  user  from  having more
        !            19:      than one clock).  It creates a window and displays the time
        !            20:      in the chosen format.
        !            21: 
        !            22: ARGUMENTS
        !            23:      -analog   Use analog display mode.  Draw a conventional 12
        !            24:               hour clock face with ``ticks'' for each minute and
        !            25:               stroke marks on each hour.  The default is digital
        !            26:               mode.
        !            27: 
        !            28:      -bg _c_o_l_o_r Determines the color of the background.       The
        !            29:               default color is ``white''.  On monochrome
        !            30:               displays this is ignored.
        !            31: 
        !            32:      -bd _c_o_l_o_r Determines the color of the border.  The defaults
        !            33:               color is ``black''.  On monochrome displays this
        !            34:               is ignored.
        !            35: 
        !            36:      -bw _p_i_x_e_l_s
        !            37:               Specify the width in pixels of the border around
        !            38:               the _x_c_l_o_c_k window.
        !            39: 
        !            40:      -digital  Use  digital  display  mode  (default).  Display
        !            41:               the date and time in digital format.
        !            42: 
        !            43:      -fg _c_o_l_o_r Determines the color of the text in digital mode
        !            44:               and the tick marks in analog mode.  The default
        !            45:               color is ``black''.  On monochrome displays this
        !            46:               is ignored.
        !            47: 
        !            48:      -hd _c_o_l_o_r Determines the color of the hands of the clock.
        !            49:               This is ignored on monchrome displays.
        !            50: 
        !            51:      -fn _f_o_n_t  The specified _f_o_n_t will be used as the output font
        !            52:               in digital mode.  Any fixed width font may be
        !            53:               used, the default is ``6x10''.
        !            54: 
        !            55:      -help     Display a brief summary of _x_c_l_o_c_k'_s calling syntax
        !            56:               and options.
        !            57: 
        !            58:      -hl _c_o_l_o_r Determines the color of the hands in analog mode.
        !            59:               The defaults is to make them the same as the
        !            60: 
        !            61: 
        !            62: 
        !            63: Printed 9/15/87            4 June 1986                         1
        !            64: 
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: 
        !            70: XCLOCK(1)          UNIX Programmer's Manual            XCLOCK(1)
        !            71: 
        !            72: 
        !            73: 
        !            74:               foreground color.  On monochrome displays this is
        !            75:               ignored.
        !            76: 
        !            77:      -padding _p_i_x_e_l_s
        !            78:               Specify the width in pixels of the padding ``white
        !            79:               space'' between the window border and anything
        !            80:               _x_c_l_o_c_k displays.  The default padding is 10 in
        !            81:               digital mode and 8 in analog mode.
        !            82: 
        !            83:      -rv       Reverses the default color values (i.e., black
        !            84:               becomes white and white becomes black).
        !            85: 
        !            86:      -update _s_e_c_o_n_d_s
        !            87:               Specify the frequency in seconds with which _x_c_l_o_c_k
        !            88:               updates its display.  If the _x_c_l_o_c_k window is
        !            89:               obscured and then exposed, _x_c_l_o_c_k will override
        !            90:               this setting  and  redisplay  immediately.   The
        !            91:               default update  frequency  is  60  seconds.   The
        !            92:               specification  of an update frequency greater than
        !            93:               30 seconds disables the display of  the  second
        !            94:               hand in analog mode.
        !            95: 
        !            96:      -chime    Cause the clock to ``chime'' once on the half hour
        !            97:               and twice on the hour.
        !            98: 
        !            99:      =_g_e_o_m_e_t_r_y
        !           100:             The clock window is created with the specified size
        !           101:             according to the geometry specification.  See _X(_1)
        !           102:             for details.  In digital mode if you do not specify
        !           103:             either height and width they are determined  by  the
        !           104:             font in use.  In analog mode if you do not specify
        !           105:             either width or height they default to 164.  The
        !           106:             default  offset  for any unspecified offset is -0.
        !           107:             All values are in pixels.
        !           108: 
        !           109:      _h_o_s_t:_d_i_s_p_l_a_y
        !           110:               Normally, _x_c_l_o_c_k gets  the host and display number
        !           111:               to use from the environment variable ``DISPLAY''.
        !           112:               One can, however specify them explicitly.  The
        !           113:               _h_o_s_t specifies which machine to create the _x_c_l_o_c_k
        !           114:               window on, and the _d_i_s_p_l_a_y argument specifies the
        !           115:               display number.  For example, ``mit-frobozz:1''
        !           116:               creates an _x_c_l_o_c_k on display one on the machine
        !           117:               mit-frobozz.  If the host is omitted the local
        !           118:               host  is  assumed.   If  the  display  is omitted,
        !           119:               display 0 is assumed, the ``:'' is necessary in
        !           120:               either case.
        !           121: 
        !           122: X DEFAULTS
        !           123:      Foreground
        !           124:             To determine the foreground color.  Ignored on mono-
        !           125:             chrome displays.
        !           126: 
        !           127: 
        !           128: 
        !           129: Printed 9/15/87            4 June 1986                         2
        !           130: 
        !           131: 
        !           132: 
        !           133: 
        !           134: 
        !           135: 
        !           136: XCLOCK(1)          UNIX Programmer's Manual            XCLOCK(1)
        !           137: 
        !           138: 
        !           139: 
        !           140:      Background
        !           141:             To determine the background color.  Ignored on mono-
        !           142:             chrome displays.
        !           143: 
        !           144:      Hands   Sets the color of the hands.  Ignored on monochrome
        !           145:             displays.
        !           146: 
        !           147:      BorderColor or Border
        !           148:             To determine the border color.  Ignored on mono-
        !           149:             chrome displays.
        !           150: 
        !           151:      BorderWidth
        !           152:             To determine the border width.
        !           153: 
        !           154:      BodyFont
        !           155:             To determine digital clock display font.
        !           156: 
        !           157:      Highlight
        !           158:             To determine the highlight color.  Ignored on mono-
        !           159:             chrome displays.
        !           160: 
        !           161:      InternalBorder
        !           162:             To determine the internal padding value.
        !           163: 
        !           164:      Mode    To determine if ``analog'' or ``digital'' mode is
        !           165:             the default.
        !           166: 
        !           167:      ReverseVideo
        !           168:             If ``on'', reverse the effect of the defaults
        !           169:             colors.  Ignored on color displays.
        !           170: 
        !           171:      Update  To determine the update rate.
        !           172: 
        !           173: ENVIRONMENT
        !           174:      DISPLAY To get the default host and display number.
        !           175: 
        !           176: SEE ALSO
        !           177:      X(1), xwm(1), X(1), time(3C), select(2)
        !           178: 
        !           179: AUTHORS
        !           180:      Copyright 1985, Massachusetts Institute of Technology.
        !           181: 
        !           182:      Tony Della Fera (MIT-Athena, DEC)
        !           183: 
        !           184:      Dave Mankins (MIT-Athena, BBN)
        !           185: 
        !           186:      Ed Moy (Berkeley) added the nicer hands.
        !           187: 
        !           188: BUGS
        !           189:      _X_c_l_o_c_k believes the Unix clock.  When specifying the window
        !           190:      size manually  in digital mode  the  string should be cen-
        !           191:      tered automatically, currently you have to fiddle with the
        !           192: 
        !           193: 
        !           194: 
        !           195: Printed 9/15/87            4 June 1986                         3
        !           196: 
        !           197: 
        !           198: 
        !           199: 
        !           200: 
        !           201: 
        !           202: XCLOCK(1)          UNIX Programmer's Manual            XCLOCK(1)
        !           203: 
        !           204: 
        !           205: 
        !           206:      padding parameter to get it right.
        !           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: Printed 9/15/87            4 June 1986                         4
        !           262: 
        !           263: 
        !           264: 

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