misc-utils/ddate.1

   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
   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 behaviour 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 (mpython@gnu.ai.mit.edu)
  94 .br
  95 Major rewrite by Lee H:. O:. Smith, KYTP, aka Andrew Bulhak (acb@dev.null.org)
  96 .br
  97 Five tons of flax.
  98
  99 .SH DISTRIBUTION POLICY
 100
 101 Public domain. All rites reversed.
 102
 103 .SH SEE ALSO
 104
 105 date(1),
 106 .br
 107 http://www.subgenius.com/
 108 .br
 109 Malaclypse the Younger,
 110 .I "Principia Discordia, Or How I Found Goddess And What I Did To Her When I Found Her"
 111
 112 .SH AVAILABILITY
 113 The ddate command is part of the util-linux-ng package and is available from
 114 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.