977b25a76a
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441.
61 lines
1.1 KiB
Groff
61 lines
1.1 KiB
Groff
.TH DATE 1
|
|
.SH NAME
|
|
date, clock \- date and time
|
|
.SH SYNOPSIS
|
|
.B date
|
|
[
|
|
.I option
|
|
] [
|
|
.I seconds
|
|
]
|
|
.br
|
|
.B clock
|
|
.SH DESCRIPTION
|
|
Print the date, in the format
|
|
.PP
|
|
.B
|
|
Tue Aug 16 17:03:52 CDT 1977
|
|
.PP
|
|
The options are
|
|
.TP
|
|
.B -u
|
|
Report Greenwich Mean Time (GMT) rather than local time.
|
|
.TP
|
|
.B -n
|
|
Report the date as the number of seconds since the
|
|
epoch, 00:00:00 GMT, January 1, 1970.
|
|
.PP
|
|
The conversion from Greenwich Mean Time to local time depends on the
|
|
.B $timezone
|
|
environment variable; see
|
|
.IM ctime (3) .
|
|
.PP
|
|
If the optional argument
|
|
.I seconds
|
|
is present, it is used as the time to convert rather than
|
|
the real time.
|
|
.PP
|
|
.I Clock
|
|
draws a simple analog clock in its window.
|
|
.\" .SH FILES
|
|
.\" .TF /adm/timezone/local
|
|
.\" .TP
|
|
.\" .B /env/timezone
|
|
.\" Current timezone name and adjustments.
|
|
.\" .TP
|
|
.\" .B /adm/timezone
|
|
.\" A directory containing timezone tables.
|
|
.\" .TP
|
|
.\" .B /adm/timezone/local
|
|
.\" Default timezone file, copied by
|
|
.\" .IR init (8)
|
|
.\" into
|
|
.\" .BR /env/timezone .
|
|
.\" .PD
|
|
.\" .PP
|
|
.\" .I Clock
|
|
.\" draws a simple analog clock in its window.
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/date.c
|
|
.br
|
|
.B \*9/src/cmd/draw/clock.c
|