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