mirror of
git://slackware.nl/current.git
synced 2024-12-30 10:24:23 +01:00
116 lines
3 KiB
Groff
116 lines
3 KiB
Groff
|
.\" All Rites Reversed. This file is in the PUBLIC DOMAIN.
|
||
|
|
.\" Kallisti.
|
||
|
|
.TH DDATE 1 "Bureaucracy 3161" "ddate" "Emperor Norton User Command"
|
||
|
|
.SH NAME
|
||
|
|
ddate \- convert Gregorian dates to Discordian dates
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B ddate
|
||
|
|
.RI [ \fB+\fPformat]
|
||
|
|
.RI [ date ]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B ddate
|
||
|
|
prints the date in Discordian date format.
|
||
|
|
.PP
|
||
|
|
If called with no arguments,
|
||
|
|
.B ddate
|
||
|
|
will get the current system date, convert this to the Discordian
|
||
|
|
date format and print this on the standard output. Alternatively, a
|
||
|
|
Gregorian date may be specified on the command line, in the form of a numerical
|
||
|
|
day, month and year.
|
||
|
|
.PP
|
||
|
|
If a format string is specified, the Discordian date will be printed in
|
||
|
|
a format specified by the string. This mechanism works similarly to the
|
||
|
|
format string mechanism of
|
||
|
|
.B date(1),
|
||
|
|
only almost completely differently. The fields are:
|
||
|
|
.IP %A
|
||
|
|
Full name of the day of the week (i.e., Sweetmorn)
|
||
|
|
.IP %a
|
||
|
|
Abbreviated name of the day of the week (i.e., SM)
|
||
|
|
.IP %B
|
||
|
|
Full name of the season (i.e., Chaos)
|
||
|
|
.IP %b
|
||
|
|
Abbreviated name of the season (i.e., Chs)
|
||
|
|
.IP %d
|
||
|
|
Cardinal number of day in season (i.e., 23)
|
||
|
|
.IP %e
|
||
|
|
Ordinal number of day in season (i.e., 23rd)
|
||
|
|
.IP %H
|
||
|
|
Name of current Holyday, if any
|
||
|
|
.IP %N
|
||
|
|
Magic code to prevent rest of format from being printed unless today is
|
||
|
|
a Holyday.
|
||
|
|
.IP %n
|
||
|
|
Newline
|
||
|
|
.IP %t
|
||
|
|
Tab
|
||
|
|
.IP %X
|
||
|
|
Number of days remaining until X-Day. (Not valid if the SubGenius options
|
||
|
|
are not compiled in.)
|
||
|
|
.IP %{
|
||
|
|
.IP %}
|
||
|
|
Used to enclose the part of the string which is to be replaced with the
|
||
|
|
words "St. Tib's Day" if the current day is St. Tib's Day.
|
||
|
|
.IP %\.
|
||
|
|
Try it and see.
|
||
|
|
.bp
|
||
|
|
.SH EXAMPLES
|
||
|
|
.nf
|
||
|
|
% ddate
|
||
|
|
.br
|
||
|
|
Sweetmorn, Bureaucracy 42, 3161 YOLD
|
||
|
|
.PP
|
||
|
|
% ddate +'Today is %{%A, the %e of %B%}, %Y. %N%nCelebrate %H'
|
||
|
|
.br
|
||
|
|
Today is Sweetmorn, the 42nd of Bureaucracy, 3161.
|
||
|
|
.PP
|
||
|
|
% ddate +"It's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H" 26 9 1995
|
||
|
|
.br
|
||
|
|
It's Prickle-Prickle, the 50th of Bureaucracy, 3161.
|
||
|
|
.br
|
||
|
|
Celebrate Bureflux
|
||
|
|
.PP
|
||
|
|
% ddate +"Today's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H" 29 2 1996
|
||
|
|
.br
|
||
|
|
Today's St. Tib's Day, 3162.
|
||
|
|
.br
|
||
|
|
|
||
|
|
.SH BUGS
|
||
|
|
|
||
|
|
.B ddate(1)
|
||
|
|
will produce undefined behavior if asked to produce the date for St. Tib's
|
||
|
|
day and its format string does not contain the St. Tib's Day delimiters
|
||
|
|
%{ and %}.
|
||
|
|
|
||
|
|
.SH NOTE
|
||
|
|
|
||
|
|
After `X-Day' passed without incident, the Church of the SubGenius
|
||
|
|
declared that it had got the year upside down - X-Day is actually in 8661 AD
|
||
|
|
rather than 1998 AD. Thus, the True X-Day is Cfn 40, 9827.
|
||
|
|
|
||
|
|
.SH AUTHOR
|
||
|
|
.nh
|
||
|
|
Original program by Druel the Chaotic aka Jeremy Johnson (mpython@gnu.ai.mit.edu)
|
||
|
|
.br
|
||
|
|
Major rewrite by Lee H:. O:. Smith, KYTP, aka Andrew Bulhak (acb@dev.null.org)
|
||
|
|
.br
|
||
|
|
Gregorian B.C.E. dates fixed by Chaplain Nyan the Wiser, aka Dan Dart (ntw@dandart.co.uk)
|
||
|
|
.br
|
||
|
|
Five tons of flax.
|
||
|
|
|
||
|
|
.SH DISTRIBUTION POLICY
|
||
|
|
|
||
|
|
Public domain. All rites reversed.
|
||
|
|
|
||
|
|
.SH SEE ALSO
|
||
|
|
|
||
|
|
date(1),
|
||
|
|
.br
|
||
|
|
http://www.subgenius.com/
|
||
|
|
.br
|
||
|
|
Malaclypse the Younger,
|
||
|
|
.I "Principia Discordia, Or How I Found Goddess And What I Did To Her When I Found Her"
|
||
|
|
|
||
|
|
.SH AVAILABILITY
|
||
|
|
The ddate command is available from https://github.com/bo0ts/ddate.
|