home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1999 May / PCWK5A99.ISO / Os2 / PDAY100.ZIP / PDAY.DOC < prev    next >
Encoding:
Text File  |  1997-10-26  |  17.2 KB  |  512 lines

  1.  
  2. Psych0Day version 1.00
  3. Public Domain by Andrew Ziem
  4.  
  5. Released: 1997-10-26
  6.  
  7.  
  8.             "He who adds not to his learning diminishes it."
  9.                                                -- The Talmud
  10.  
  11.  
  12.  
  13. -= Introduction
  14.  
  15.   Psych0Day is a combination of programs dealing with time.  It can
  16.   report what happened in history, whose birthday it is, astronomical
  17.   events, religious happenings, and the phase of the moon as well as
  18.   converting the date to other calendars.  Psych0Day came to be from
  19.   inspiration of several programs and an article by Robert Anton Wilson.
  20.  
  21.   TODAY has many incarnations.  The original was written by Mike Butler
  22.   in PL/1 on an IBM VM/CMS system.  This inspired Patrick Kincaid to
  23.   write TODAY/PC in Datalight C in July of 1986.  OS2DAY, authored by
  24.   Oleg Titov, is the OS/2 incarnation that I have been using until now.
  25.  
  26.  
  27. -= "License Agreement"
  28.  
  29.   Psych0Day is hereby released to the public domain.  Portions, however,
  30.   were not written by me and belong to their respect authors.  I believe
  31.   what's what is cleary marked.
  32.  
  33.   Now that I've given you something, you could do something for me, eh?
  34.  
  35.   Psych0Day has yet to be abandoned.  =)  If you make any neat
  36.   improvments or modifications, send them to me.  Atleast drop me a
  37.   note; I'd like to see how this thing gets around.
  38.  
  39.   Psych0Day is provided `as is' without warranty of any kind, expresed,
  40.   implied or otherwise.  If it breaks, you keep both pieces.
  41.  
  42.  
  43. -= Command Line Arguments
  44.  
  45.   These can also be listed by running "PDAY ?".  The command line is
  46.   case insensitive.
  47.  
  48.   Usage: PDAY [{-|+}c[x]] [-Fdd[mm[yyyy]]] [-i] [{-|+}l[x]]
  49.               [-libdir=drive:\\dir\\]
  50.       or PDAY 
  51.  
  52.  
  53.   Switches:
  54.  
  55. *     c: toggle display of calendars (all on by default)
  56.      cd: toggle Discordian
  57.      cf: toggle French Republican
  58.      cg: toggle Gregorian
  59.      ci: toggle Illuminati
  60.      cj: toggle Julian
  61.      cl: toggle Goddess Lunar
  62.      ct: toggle Thelemic (disabled)
  63.       f: force date in the format dd[mm[yyyy]]
  64.       i: display program information
  65. *     l: toggle library support (all on by default)
  66.      lb: toggle birthdays
  67.      le: toggle events
  68.      lr: toggle reminders
  69.  libdir: specify library directory
  70.  
  71.  * = does not work in OS/2.
  72.  
  73.  
  74.   Examples:
  75.  
  76.   ex1: PDAY
  77.   Run with all defaults and search current directory for library files.
  78.  
  79.   ex2: PDAY -f09101981
  80.   Same as ex1 except the date October 9th, E.V. 1981 is forced.
  81.  
  82.   ex3: PDAY -f0910
  83.   Same as ex1 except the date October 9th of the current year is forced.
  84.  
  85.   ex4: PDAY -libdir=c:\apps\pday\
  86.   Same as ex1 except the directory `c:\os2\apps\pday' is searched for the
  87.   library files.
  88.  
  89.   ex5: PDAY -cj -cf
  90.   Same as ex1 except the Julian and French Republican calendars are disabled.
  91.  
  92.   ex6: PDAY -c +cd
  93.   Same as ex1 except the calendar displayed is the Discordian.  (This
  94.   neat little trick is possible because the command line is parsed from
  95.   left to right.)
  96.  
  97.   ex7: PDAY -l
  98.   Same as ex1 except all no database libraries are displayed.
  99.  
  100.   ex8: PDAY -le -lb
  101.   Same as ex1 except library events and birthdays are disabled.
  102.  
  103.  
  104. -= Included Files
  105.  
  106.   If any of these are missing or damaged, see the end of this document
  107.   for information on how to get a fresh copy of Psych0Day.
  108.  
  109.     PDAY    .EXE     DOS 16-bit executable
  110.     PDAY2   .EXE     OS/2 32-bit executable
  111.  
  112.     PDAY    .DOC     this documentation
  113.     README  .xxx     important notes for version xxx, changes, etc.
  114.  
  115.     ASTRO   .ALL     astrological happenings for 1997
  116.     CHURCH  .ALL     religious happenings
  117.     MUSIC   .ALL     happenings related to music
  118.     PSYCH0  .ALL     my own general additions
  119.     TODAY   .ZIP     Patrick Kincaid's original TODAY.??? files
  120.  
  121.     SRC     .ZIP     source code; only needed pieces of the packages used have
  122.                      been included as not to waste space
  123.                      ** contains nested subdirectories: use "PKUNZIP -D"
  124.  
  125.       COMMON  .H       common things of mine
  126.       NAME    .H       standarizes names
  127.       GLC\*.*          Goddess Lunar calendar source
  128.       SDNCAL20\*.*     Julian and French Republican calendar source
  129.       SNIPPTS\*.*      various things from SNIPPETS
  130.  
  131.     TODAY   .BAT     script interface for Telegard v3.0x
  132.     TODAY   .SRC     script interface for Telegard v3.0x
  133.  
  134.     FILE_ID .DIZ     BBS-compatible description
  135.     PSYCH0  .LST     other programs by me available
  136.  
  137.  
  138. -= Redirection
  139.  
  140.   Psych0Day's output can be redirected, or piped, to a file or a device.
  141.   Below are several examples of how this done.  You may wish to see your
  142.   system manuals for more information.
  143.  
  144.   Note: Error messages are not piped but instead always sent to the
  145.   console.
  146.  
  147.  
  148.     PDAY > COM1
  149.     Sends the output to the first communications port.
  150.  
  151.     PDAY > PRN
  152.     Data is sent to the default printer.
  153.  
  154.     PDAY > NUL
  155.     This is useless considering Psych0Day's function, but the data is sent
  156.     to the null device (i.e., oblivion).
  157.  
  158.     PDAY > c:\bbs\texts\today.asc
  159.     The file "c:\bbs\texts\today.asc" is overwritten, if it exists.  If it
  160.     doesn't, it is created.
  161.  
  162.     PDAY >> c:\bbs\logs\today.log
  163.     The file "c:\bbs\logs\today.log" is appended with Psych0Day's output.  If
  164.     it doesn't, it is created.
  165.  
  166.     PDAY | MORE
  167.     Output is sent to the program "MORE", which included with many
  168.     operating systems.  MORE pauses and waits for your input when the
  169.     page is full.
  170.  
  171.  
  172. -= The Calendars
  173.  
  174.   Once I have the information I need, I will be adding the Chinese,
  175.   Clavian, Fixed, Hebrew, Islamic, Mayan, 'Pataphysical, Positivist,
  176.   Poundian and World calendars, Stardates, Galactic Milieu dates, and
  177.   astrological and astronomical information.
  178.  
  179.   I wish I could gaurantee the information included here, but I cannot.
  180.   Trust at your own risk.
  181.  
  182.   See the section entitled "References and Recommended Reading" and the
  183.   included file "CALENDAR.FAQ".
  184.  
  185.  
  186.    Discordian/Erisian/POEE:
  187.  
  188.     Valid dates:
  189.      years 1 through [unknown] (Discordian)
  190.      or 1166 B.C. through [unknown] (Gregorian)
  191.  
  192.     There are 5 seasons in a year, 73 days in each season, 5 days in a
  193.     week, and things are dated from 1184 B.C. Gregorian.  You must read
  194.     the Principia Discordia to fully understand and appreciate this one.
  195.  
  196.  
  197.    French Republican:
  198.  
  199.     Valid dates:
  200.      years 1 through 14 (French Republican)
  201.      or September 22, E.V. 1792 through September 22, E.V. 1806 (Gregorian)
  202.  
  203.     "The French republican calendar was adopted in October 1793 during
  204.     the French Revolution and was abandoned in January 1806.  The intent
  205.     was to create a new calendar system that was based on scientific
  206.     principals, not religious traditions.
  207.  
  208.     The year is divided into 12 months of 30 days each.  The remaining 5
  209.     to 6 days in the year are grouped at the end and are holidays.  Each
  210.     month is divided into three decades (instead of weeks) of 10 days
  211.     each.
  212.  
  213.     The epoch (first day of the first year) is 22 September 1792 in the
  214.     Gregorian calendar.  Leap years are every fourth year (year 3, 7,
  215.     11, etc.)" -- Scott E. Lee (French.C)
  216.  
  217.  
  218.    Goddess Lunar:
  219.  
  220.     Valid dates:
  221.      atleast 4000 B.C. through E.V. 10,000 (Gregorian)
  222.  
  223.     I know little about this lunar based calendar.  I suspect it was
  224.     created recently by Peter Meyer.  There are 26 months; each month is
  225.     named after a goddess: Artemis, Bast, Cybele, Durga, Eris, Freya,
  226.     Gaea, Hathor, Ix Chel, Juno, Kali, Luna, Maat, Nisaba, Oya,
  227.     Persephone, Quan Yin, Rhiannon, Saraswati, Tara, Usha, Venus,
  228.     Waka-Hiru-Me, Xochiquetzal, Yemaya.
  229.  
  230.  
  231.    Gregorian:
  232.  
  233.     Valid dates:
  234.      probably 4714 B.C. through E.V. 10,000 (Gregorian)
  235.  
  236.     This is the Christian calendar most of use on a daily basis.  There
  237.     are 12 months, 4 seasons, or 365.25 days in 1 year.
  238.  
  239.  
  240.    Illuminati:
  241.  
  242.     Valid dates:
  243.      years 1 through [unknown] (Illuminati)
  244.      or 4000 B.C. through [unknown] (Gregorian)
  245.  
  246.     This is based on the Discordian calendar and comes to use from the
  247.     Illuminatus! books written by Bob Shea and Robert Anton Wilson.
  248.  
  249.  
  250.    Julian:
  251.  
  252.     Valid dates:
  253.      4713 B.C. to at least E.V. 10,000
  254.  
  255.     "The Julian calendar was introduced by Julius Caesar in 45 BC. It was
  256.     in common use until the 1500s, when countries started changing to
  257.     the Gregorian calendar. However, some countries (for example, Greece
  258.     and Russia) used it into this century, and the Orthodox church in
  259.     Russia still uses it, as do some other Orthodox churches.
  260.  
  261.     In the Julian calendar, the tropical year is approximated as 365 1/4
  262.     days = 365.25 days. This gives an error of 1 day in approximately
  263.     128 years.
  264.  
  265.     The approximation 365 1/4 is achieved by having 1 leap year every 4
  266.     years." -- The Calendar FAQ (CALENDAR.FAQ)
  267.  
  268.  
  269.   Julain Day Number (JDN):
  270.  
  271.     Valid dates:
  272.      JDNs 1 through [unknown]
  273.      January 1st, 4713 B.C. through E.V. 3267 (Gregorian)
  274.  
  275.     The Julian day number, not to be confused with the Julian calendar,
  276.     is a positive real number measuring the days from January 1st, 4713
  277.     B.C. (Julian calendar).  Psych0Day does not take in account the time
  278.     of day to calculate the number.
  279.  
  280.  
  281.   Thelemic:
  282.  
  283.     Valid dates:
  284.      March 20, 1904 E.V. through [unknown] (Gregorgian)
  285.  
  286.     ** The Thelemic calendar is off by default as it is not yet fully
  287.     implemented. **
  288.  
  289.     This calender begins at the begining of the New Age of Horus, or March 20,
  290.     1904.
  291.  
  292.  
  293. -= Terms and Vocabulary
  294.  
  295.  This section is incomplete.  See also the Calender FAQ (CALENDAR.FAQ)
  296.  for more information.
  297.  
  298.  
  299.   anno Domini (A.D.)              Latin meaning "in the year of the (our)
  300.                                   Lord."  Measures time after the supposed
  301.                                   birth of Christ.
  302.  
  303.   Anno Lumina (A.L.)              Latin meaning "year of light."  1 A.L.
  304.                                   equals 4000 B.C.E and marks the birth of Hung
  305.                                   Mung.
  306.  
  307.   before Christ (B.C.)            Indicates years before the supposed birth
  308.                                   of Christ.
  309.  
  310.   before common era (B.C.E.)      Used in secular and scholarly contents
  311.                                   instead of B.C.
  312.  
  313.   common era (C.E.)               Used in secular and scholarly contents
  314.                                   instead of A.D.
  315.  
  316.   era vulgaris (E.V.)             Latin for "common era."  Equivilent to the
  317.                                   modern "C.E." used in secular and scholarly
  318.                                   contents instead of A.D.
  319.  
  320.   year of Confusion (y.C.)        Years since 1166 B.C.E. when Greyface began
  321.                                   "deluding honest men to believe that reality
  322.                                   was a straightjacket affair and not the happy
  323.                                   romance as men had known it."  Discordian.
  324.  
  325.  
  326. -= References and Recommended Reading
  327.  
  328.   Title:       Calendar Information Page
  329.   Author:      Will Linden (wlinden@panix.com)
  330.   URL:         http://www.panix.com/~wlinden/calendar.shtml
  331.  
  332.     Today's date in various calendars and eras, celestial and
  333.     astronomical information, and many good links.
  334.  
  335.  
  336.   Title:       Calendar Studies
  337.   Author:      Peter Meyer (serendipity@magnet.ch)
  338.   URL:         http://www.magnet.ch/serendipity/cal_stud.html
  339.  
  340.     Information covering the Mayan, Goddess Lunar, Gregorian, Julian and
  341.     other lunar calendars.
  342.  
  343.  
  344.   Title:       Celestial Delight: The Best Astronomical Events through 2001
  345.   Authors:     Francis Reddy and Greg Walz-Chojnacki
  346.   Publisher:   (?) Berkeley California: CelestialArts
  347.  
  348.     Great for novice astronomers.  Has history, planet data, and a table
  349.     of events (visable planets, full moons, asteriod showers, etc.) from
  350.     about 1990 to 2001 (like the name implies).
  351.  
  352.  
  353.   Title:       Frequently Asked Questions About Calendars
  354.   Author:      Claus Tondering (c-t@pip.dknet.dk)
  355.   Included as: CALENDAR.FAQ
  356.   Newsgroups:  sci.astro, soc.history
  357.   WWW:         www.pip.dknet.dk/~pip10160/calendar.html
  358.  
  359.     Contains answers to frequently asked questions about the Christian,
  360.     Hebrew, Islamic, and various historical calendars.
  361.  
  362.  
  363.   Title:       How to Live Eleven Days in 24 Hours
  364.   Author:      Robert Anton Wilson
  365.   Included as: RAWTIME.TXT
  366.  
  367.     This is the article inspired me to write Psych0Day.  Robert Anton
  368.     Wilson writes of using a "no-bias multi-cultural" calendar.
  369.     Explained herein are 11 systems.
  370.  
  371.     I'd like to know where this was originally published.
  372.  
  373.  
  374.   Title:       Illuminatus! Trilogy
  375.   Authors:     Bob Shea and Robert Anton Wilson
  376.   Publisher:   Dell Publishing
  377.   ISBN:        0-440-34742-4 (part III: Leviatan)
  378.   URL:         http://www.rawilsom.com (R.A. Wilson's web page)
  379.  
  380.     I've finally found one of the books, the third, at a used book
  381.     store, but I haven't started reading because I want it in order.  I
  382.     haven't bought the trilogy as one book because it is much abridged.
  383.  
  384.  
  385.   Title:      Principia Discordia
  386.   Author:     Malaclypse the Younger
  387.   Publisher:  Loompanics Unlimited, Port Townsend, Washington
  388.           or  IllumiNet Press, P.O. Box 2808, Libum, Georgia 30226
  389.   ISBN:       0-9626534-2-X (4th/5th edition)
  390.   File:       PRINCIPI.TXT
  391.   WWW:        www.informatik.hu-berlin.de/~bach/gwd/principia/body.html
  392.  
  393.     The Discordian Bible wherein is explained absolutely everything
  394.     worth knowing about absolutely anything.
  395.  
  396.     There are many versions floating around. The one I've seen in print
  397.     is a combination of the 4th and 5th editions; the one I have in
  398.     ASCII is the 5th edition; I don't know about the scanned (.GIF) and
  399.     HTML versions.
  400.  
  401.  
  402.   Title:       SNIPPETS
  403.   F'REQ:       "SNIPPETS" from 1:106/2000 or 1:2320/38
  404.   FTP:         snippets.org/pub/snippets
  405.   WWW:         www.snippets.org
  406.  
  407.     SNIPPETS is a huge collection of C source snippets where I have
  408.     found many a useful thing.  I've included the pieces used in this
  409.     program.
  410.  
  411.  
  412.   Title:       Thelemic Calendar and Holidays
  413.   WWW:         http://www5.crl.com/~thelema/calendar.html
  414.   Mainted by:  Vere Chappell (thelema@crl.com)
  415.  
  416.  
  417.   Title:       Yahoo! - Reference:Calendars
  418.   URL:         http://www.yahoo.com/Reference/Calendars/
  419.  
  420.     A good starting point for research on the WWW.
  421.  
  422.  
  423. -= Thank You, Mr. Psych0 Man
  424.  
  425.   I've put a good deal of time, money, etc. making Psych0Day something
  426.   useful to others.  Those were entertaining and illumating hours, but
  427.   if you want me to continue, please indulge my fantasy that someone is
  428.   actually using it.
  429.  
  430.   The best way to tell me you like the program is to send me something.
  431.   Something material, like a postcard, would be appreciated most.  I'd
  432.   also be tickled to find e-mails, database additions, and yep, even
  433.   money.
  434.  
  435.   Andrew Ziem
  436.   3080 Woodview Ct.
  437.   Colorado Springs, CO 80918-4635
  438.   The United States of America
  439.   North American Continent
  440.   Earth
  441.   Third Planet in the Sol System (G2V)
  442.   Orion Arm
  443.   Milky Way Galaxy
  444.   Local Cluster
  445.   And a Cherry On Top
  446.  
  447.  
  448. -= Where in the World is Psych0?
  449.  
  450.   Andrew Ziem is Psych0 and Psych0Soft.
  451.  
  452.   E-mail      psych0o@juno.com
  453.               psych0o@aol.com
  454.   FidoNet     1:128/234: TG_SUPPORT and other echoes
  455.   Direct      Psychosis BBS
  456.                +1 (719) 532-0053 -- Zoom v34
  457.                +1 (719) 532-1265 -- Supra v34
  458.                login: GUEST  password: GUEST
  459.  
  460.  
  461. -= Distribution
  462.  
  463.   FTP         ftp://members.aol.com/psych0o/
  464.               ftp://ftp.simtel.net/pub/msdos/   (exact directory yet unknown)
  465.  
  466.   WWW         http://members.aol.com/psych0o/psoft.htm
  467.               ***Only use the following if the above does not work:
  468.                   http://www.angelfire.com/co/psych0o/psoft.html
  469.  
  470.   FidoNet     1:128/234, FREQ: PDAY
  471.  
  472.   Direct      Psychosis BBS
  473.                +1 (719) 532-0053 -- Zoom v34
  474.                +1 (719) 532-1265 -- Supra v34
  475.                login: GUEST  password: GUEST
  476.  
  477.  
  478. -= Acknowledgments and Credits (in no particular order)
  479.  
  480.   Everyone and everything in the "References and Recommended Reading"
  481.   section has been a huge help, many thanks.
  482.  
  483.   Oblivion for proof-reading this, providing webspace...
  484.  
  485.   Public domain code from
  486.    Bob Stout and Mark Kamradt: COMMAFMT.C -- format number with commas;
  487.    Bob Stout: DAYNUM.C -- general date routines;
  488.    Scott E. Lee: FRENCH.C and JULIAN.C -- convert date to Julian and French
  489.      calendars;
  490.    Paul Schlyter, Raymond Gardner and Tom Van Flandern: JDN_L.C -- compute
  491.      Julian Day Number;
  492.    Jim Walsh, Dann Corbit, Bob Stout, and others: L2ROMAN.C -- convert number
  493.      to Roman numerals;
  494.    Peter Meyer: LUNCONV.C -- convert date to Goddess Lunar calendars;
  495.    M. Kimes, Lynn Nash, BSD Unix -- moon phase routines;
  496.    Robert B.Stout: ORD_TEXT.C -- adds "st", "nd", "rd", etc. to numbers;
  497.    and Ray Gardner: SCALDATE.C -- general date routines.
  498.  
  499.   Portions copyright 1993-1995, Scott E. Lee, all rights reserved.
  500.  
  501.   MS-DOS                 Microsoft Corp.
  502.   OS2DAY                 Oleg Titov
  503.   OS/2                   International Business Machines Corp.
  504.   TODAY                  Michael W. Butler
  505.   TODAY/PC               Patrick Kincaid
  506.  
  507.   All other programs are copyright and/or trademarked by their
  508.   respective author unless otherwise noted.
  509.  
  510.  
  511. -- end of file "PDAY.DOC"
  512.