| 1 |
.\" All Rites Reversed. This file is in the PUBLIC DOMAIN. |
| 2 |
.\" Kallisti. |
| 3 |
.TH DDATE 1 "Bureaucracy 3161" "ddate" "Emperor Norton User Command" |
| 4 |
.SH NAME |
| 5 |
ddate \- convert Gregorian dates to Discordian dates |
| 6 |
.SH SYNOPSIS |
| 7 |
.B ddate |
| 8 |
.RI [ \fB+\fPformat] |
| 9 |
.RI [ date ] |
| 10 |
.SH DESCRIPTION |
| 11 |
.B ddate |
| 12 |
prints the date in Discordian date format. |
| 13 |
.PP |
| 14 |
If called with no arguments, |
| 15 |
.B ddate |
| 16 |
will get the current system date, convert this to the Discordian |
| 17 |
date format and print this on the standard output. Alternatively, a |
| 18 |
Gregorian date may be specified on the command line, in the form of a numerical |
| 19 |
day, month and year. |
| 20 |
.PP |
| 21 |
If a format string is specified, the Discordian date will be printed in |
| 22 |
a format specified by the string. This mechanism works similarly to the |
| 23 |
format string mechanism of |
| 24 |
.B date(1), |
| 25 |
only almost completely differently. The fields are: |
| 26 |
.IP %A |
| 27 |
Full name of the day of the week (i.e., Sweetmorn) |
| 28 |
.IP %a |
| 29 |
Abbreviated name of the day of the week (i.e., SM) |
| 30 |
.IP %B |
| 31 |
Full name of the season (i.e., Chaos) |
| 32 |
.IP %b |
| 33 |
Abbreviated name of the season (i.e., Chs) |
| 34 |
.IP %d |
| 35 |
Ordinal number of day in season (i.e., 23) |
| 36 |
.IP %e |
| 37 |
Cardinal number of day in season (i.e., 23rd) |
| 38 |
.IP %H |
| 39 |
Name of current Holyday, if any |
| 40 |
.IP %N |
| 41 |
Magic code to prevent rest of format from being printed unless today is |
| 42 |
a Holyday. |
| 43 |
.IP %n |
| 44 |
Newline |
| 45 |
.IP %t |
| 46 |
Tab |
| 47 |
.IP %X |
| 48 |
Number of days remaining until X-Day. (Not valid if the SubGenius options |
| 49 |
are not compiled in.) |
| 50 |
.IP %{ |
| 51 |
.IP %} |
| 52 |
Used to enclose the part of the string which is to be replaced with the |
| 53 |
words "St. Tib's Day" if the current day is St. Tib's Day. |
| 54 |
.IP %\. |
| 55 |
Try it and see. |
| 56 |
.bp |
| 57 |
.SH EXAMPLES |
| 58 |
.nf |
| 59 |
% ddate |
| 60 |
.br |
| 61 |
Sweetmorn, Bureaucracy 42, 3161 YOLD |
| 62 |
.PP |
| 63 |
% ddate +'Today is %{%A, the %e of %B%}, %Y. %N%nCelebrate %H' |
| 64 |
.br |
| 65 |
Today is Sweetmorn, the 42nd of Bureaucracy, 3161. |
| 66 |
.PP |
| 67 |
% ddate +"It's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H" 26 9 1995 |
| 68 |
.br |
| 69 |
It's Prickle-Prickle, the 50th of Bureaucracy, 3161. |
| 70 |
.br |
| 71 |
Celebrate Bureflux |
| 72 |
.PP |
| 73 |
% ddate +"Today's %{%A, the %e of %B%}, %Y. %N%nCelebrate %H" 29 2 1996 |
| 74 |
.br |
| 75 |
Today's St. Tib's Day, 3162. |
| 76 |
.br |
| 77 |
|
| 78 |
.SH BUGS |
| 79 |
|
| 80 |
.B ddate(1) |
| 81 |
will produce undefined behavior if asked to produce the date for St. Tib's |
| 82 |
day and its format string does not contain the St. Tib's Day delimiters |
| 83 |
%{ and %}. |
| 84 |
|
| 85 |
.SH NOTE |
| 86 |
|
| 87 |
After `X-Day' passed without incident, the Church of the SubGenius |
| 88 |
declared that it had got the year upside down - X-Day is actually in 8661 AD |
| 89 |
rather than 1998 AD. Thus, the True X-Day is Cfn 40, 9827. |
| 90 |
|
| 91 |
.SH AUTHOR |
| 92 |
.nh |
| 93 |
Original program by Druel the Chaotic aka Jeremy Johnson ([email protected]) |
| 94 |
.br |
| 95 |
Major rewrite by Lee H:. O:. Smith, KYTP, aka Andrew Bulhak ([email protected]) |
| 96 |
.br |
| 97 |
Gregorian B.C.E. dates fixed by Chaplain Nyan the Wiser, aka Dan Dart ([email protected]) |
| 98 |
.br |
| 99 |
Five tons of flax. |
| 100 |
|
| 101 |
.SH DISTRIBUTION POLICY |
| 102 |
|
| 103 |
Public domain. All rites reversed. |
| 104 |
|
| 105 |
.SH SEE ALSO |
| 106 |
|
| 107 |
date(1), |
| 108 |
.br |
| 109 |
http://www.subgenius.com/ |
| 110 |
.br |
| 111 |
Malaclypse the Younger, |
| 112 |
.I "Principia Discordia, Or How I Found Goddess And What I Did To Her When I Found Her" |
| 113 |
|
| 114 |
.SH AVAILABILITY |
| 115 |
The ddate command is available from https://github.com/bo0ts/ddate. |