                        -= Psych0Day documentation =-



Psych0Day version 1.15 
(k) by Andrew Ziem 1997, 1998, 1999

Released: 1999-03-18 (Gregorian) 

                                   /"With Psych0Day, your days are numbered!"/

                   [ Psych0Soft online | Psych0Day online ]

Contents


    * Introduction 
    * License Agreement 
    * Command Line Arguments 
    * Included Files 
    * Redirection 
    * Common Problems: "Load error: no DPMI" 
    * Common Problems: not enough memory using PAT386.EXE under OS/2 
    * Common Problems: "emx not found" 
    * References and Recommended Reading 
    * Distribution 
    * Acknowledgments and Credits 

Introduction

Psych0Day is a combination of programs dealing with time. It can report what
happened in history, whose birthday it is, astronomical events, religious
happenings and the phase of the moon as well as display the date in a variety
of calender systems. Psych0Day came from from inspiration of several programs
and an article by Robert Anton Wilson (included in this archive). 

TODAY has many incarnations. The original was written by Mike Butler in PL/1
on an IBM VM/CMS system. This, in turn, inspired Patrick Kincaid to write
TODAY/PC in Datalight C in July of 1986. OS2DAY, authored by Oleg Titov, is
the OS/2 incarnation that I had been using until I wrote Psych0Day. 

License Agreement

Psych0Day is hereby released to the public domain. Portions, however, were not
written by me and belong to their respect authors. I believe what's what is
cleary marked. 

If you make any neat improvements or modifications, send them to me. At least
drop me a note: I'd like to see how this thing gets around. 

Psych0Day is provided `as is.' There is no warranty of any kind-- expresed,
implied or otherwise. If it breaks, you keep both pieces. 

Furthermore, the accuracy of this program is not guaranteed. 

Command Line Arguments

These can also be listed by running *PDAY ?*. The command line is case
insensitive. 


  Usage: PDAY [{-|+}c[x]] [-Fdd[mm[yyyy]]] [-i] [{-|+}l[x]]
              [-dir=drive:\\dir\\]
      or PDAY 


Switches:


      c: toggle display of calendars (all on by default)
     cd: toggle Discordian
     cf: toggle French Republican
     cg: toggle Gregorian
     ci: toggle Illuminati
     cj: toggle Julian
     cl: toggle Goddess Lunar
     ct: toggle Thelemic (disabled)
      f: force date in the format dd[mm[yyyy]]
      i: display program information
      l: toggle library support (all on by default)
     lb: toggle birthdays
     le: toggle events
     lr: toggle reminders
    lib: specify library directory


Examples:

ex1: PDAY 
Run with all defaults and search current directory for library files. 

ex2: PDAY -f09101981 
The date October 9th, E.V. 1981 is used. 

ex3: PDAY -f0910 
The date October 9th of the current year is used. 

ex4: PDAY -libdir=c:\apps\pday\ 
The directory `c:\apps\pday\' is searched for the library files. Notice that
the trailing backslash is required! 

ex5: PDAY -cj -cf 
The Julian and French Republican calendars are disabled. 

ex6: PDAY -c +cd 
The calendar displayed is the Discordian. (This neat little trick is possible
because the command line is parsed from left to right.) 

ex7: PDAY -l 
Same as ex1 except all no database libraries are displayed. 

ex8: PDAY -le -lb 
Same as ex1 except library events and birthdays are disabled. 

Included Files

If any of these are missing or damaged, see the end of this document for
information on how to get a fresh copy of Psych0Day. 



    PDAY    .EXE     DOS 16-bit executable
    PDAY2   .EXE     OS/2 32-bit executable (requires EMXRT)
    PDAY386 .EXE     DOS 32-bit executlabe (requires DPMI server)
    PDAY95  .EXE     Windows 95 32-bit executable (requires RSXNT.DLL)

    PDAY_DOC.HTM     HTML documentation
    PDAY_DOC.TXT     text documentation
    README  .xxx     important notes for version xxx, changes, etc.

    RAWTIME .TXT     R.A.W.'s "How to Live Eleven Days in 24 Hours"

    CHURCH  .ALL     religious happenings
    MUSIC   .ALL     happenings related to music
    PSYCH0  .ALL     my own general additions
    TODAY   .ZIP     Patrick Kincaid's original TODAY.??? files

    SRC     .ZIP     source code; only needed pieces of the packages used
                     have been included as not to waste space
                     ** contains nested subdirectories: use _PKUNZIP -D_

    FILE_ID .DIZ     BBS-compatible description



Redirection

Psych0Day's output can be redirected (piped) to a file or a device. Below are
several examples of how this done. You may wish to see your system manuals for
more information. 

Note: error messages are not piped but instead always sent to the console. 

*PDAY > COM1* 
Sends the output to the first communications port. 

*PDAY > PRN* 
Data is sent to the default printer. 

*PDAY > NUL* 
This is useless considering Psych0Day's function, but the data is sent to the
null device (i.e., oblivion). 

*PDAY > c:\bbs\texts\today.asc* 
The file /c:\bbs\texts\today.asc/ is overwritten, if it exists. If it doesn't,
it is created. 

*PDAY >> c:\bbs\logs\today.log* 
The file /c:\bbs\logs\today.log/ is appended with Psych0Day's output. If it
doesn't, it is created. 

*PDAY | MORE* 
Output is sent to the program /MORE/, which included with many operating
systems. /MORE/ pauses and waits for your input when the page is full. 

Common Problems: "Load error: no DPMI" (DOS)

The PAT386.EXE requires /DPMI/ (DOS Protected Mode Interface) to access
extended memory. You must either install a DPMI host or use another version. 

Available hosts include Windows v3.1, '95 and '98 (in a box running DOS); OS/2
(in the DOS box a.k.a. VDM); QEMM; and CWSDPMI. CWSDPMI is available for free
and works very well. 

CWSDPMI from ftp.cdrom.com via FTP 
CWSDPMI from members.xoom.com via HTTP 

Common Problems: not enough memory using PAT386.EXE under OS/2

In the DOS Settings, set your DPMI_DOS_API to ENABLED (instead of AUTO) and
increase the DPMI_MEMORY_LIMIT to atleast 16 megabytes. 

Common Problems: "emx not found" (OS/2)

PAT2.EXE requires /the EMX runtime library/ to access certain functions. You
must install the /emxrt/ or use another version. 

emxrt from hobbes.nmsu.edu via HTTP 
emxrt from members.xoom.com via HTTP 

Common Problems: "rsxnt.dll not found" (Win32)

PAT95.EXE requires the RSX runtime library (RSXNT.DLL). 

rsxnt.dll from members.xoom.com via HTTP 

References and Recommended Reading

Title: Calendar Information Page 
Author: Will Linden (wlinden@panix.com) 
URL: http://www.panix.com/~wlinden/calendar.shtml 

Today's date in various calendars and eras, celestial and astronomical
   information, and many good links. 

Title: Calendar Studies 
Author: Peter Meyer (serendipity@magnet.ch) 
URL: http://www.magnet.ch/serendipity/cal_stud.html 

Information covering the Mayan, Goddess Lunar, Gregorian, Julian and other
   lunar calendars. 

Title: Celestial Delight: The Best Astronomical Events through 2001 
Authors: Francis Reddy and Greg Walz-Chojnacki 
Publisher: (?) Berkeley California: CelestialArts 

Great for novice astronomers. Has history, planet data, and a table of
   events (visable planets, full moons, asteriod showers, etc.) from about
   1990 to 2001 (like the name implies). 

Title: Frequently Asked Questions About Calendars 
Author: Claus Tondering (c-t@pip.dknet.dk) 
Included as: CALENDAR.FAQ 
WWW: www.pip.dknet.dk/~pip10160/calendar.html 

Contains answers to frequently asked questions about the Christian, Hebrew,
   Islamic, and various historical calendars. 

Title: How to Live Eleven Days in 24 Hours 
Author: Robert Anton Wilson 
Included as: RAWTIME.TXT 

This is the article inspired me to write Psych0Day. Robert Anton Wilson
   writes of using a "no-bias multi-cultural" calendar. Explained herein are
   11 systems. 
   
   I'd like to know where this was originally published. 

Title: Illuminatus! Trilogy 
Authors: Bob Shea and Robert Anton Wilson 
Publisher: Dell Publishing 
URL: http://www.rawilsom.com (R.A. Wilson's web page) 

I've finally found one of the books, the third, at a used book store, but I
   haven't started reading because I want it in order. I haven't bought the
   trilogy as one book because it is much abridged. 

Title: Principia Discordia 
Author: Malaclypse the Younger 
Publisher: Loompanics Unlimited, Port Townsend, Washington 
Publisher: (or) IllumiNet Press, P.O. Box 2808, Libum, Georgia 30226 
ISBN: 0-9626534-2-X (4th/5th edition) 
WWW: www.informatik.hu-berlin.de/~bach/gwd/principia/body.html 

The Discordian Bible wherein is explained absolutely everything worth
   knowing about absolutely anything. 

There are many versions floating around. The one I've seen in print is a
   combination of the 4th and 5th editions; the one I have in ASCII is the 5th
   edition; I don't know about the scanned (.GIF) and HTML versions. 

Title: SNIPPETS 
F'REQ: *SNIPPETS* from 1:106/2000 or 1:2320/38 
FTP: snippets.org/pub/snippets 
WWW: www.snippets.org 

SNIPPETS is a huge collection of C source snippets where I have found many
   a useful thing. I've included the pieces used in this program. 

Title: Thelemic Calendar and Holidays 
WWW: http://www5.crl.com/~thelema/calendar.html 
Maintained by: Vere Chappell (thelema@crl.com) 

Title: Yahoo! - Reference:Calendars 
URL: http://www.yahoo.com/Reference/Calendars/ 

A good starting point for research on the WWW. 

Title: Psych0's Bookmark 
URL: http://www.angelfire.com/co/psych0o/links.html#astrology 

Where in the World is Psych0?

Andrew Ziem is Psych0 and Psych0Soft. 

*E-mail* 
psych0o@juno.com 
ziem@iex.net 

*Snail* 
3080 Woodview Ct. 
Colorado Springs, CO 80918-4635 
Colorado Springs, CO 80918-4635 

Distribution

Look for the latest updates directly from the Psych0Day website. 

*File Naming Conventions* 

Where xxx signifies the version release: 
all: PDAYxxx.ZIP (DOS, OS/2 and Windows) 
DOS: PDAYxxxD.ZIP (16-bit and 32-bit) 
OS2: PDAYxxxO.ZIP 
W95: PDAYxxxW.ZIP 

*WWW* 
http://www.members.xoom.com/sdexter/psoft/ 
http://www.members.xoom.com/sdexter/psoft/pday.html 

*Sites* 
Simtel archive 
Hobbes archive 

Acknowledgments and Credits (in no particular order)

Public domain code from 
    * Bob Stout and Mark Kamradt: COMMAFMT.C; 
    * Bob Stout: DAYNUM.C; 
    * Scott E. Lee: FRENCH.C and JULIAN.C calendars; 
    * Paul Schlyter, Raymond Gardner and Tom Van Flandern: JDN_L.C; 
    * Jim Walsh, Dann Corbit, Bob Stout, and others: L2ROMAN.C; 
    * Peter Meyer: LUNCONV.C; 
    * M. Kimes, Lynn Nash, BSD Unix; 
    * Robert B.Stout: ORD_TEXT.C; 
    * and Ray Gardner: SCALDATE.C. 

Portions copyright 1993-1995, Scott E. Lee, all rights reserved. 
DJGPP        DJ Delorie                              
EMX          Eberhart Mattes                         
MS-DOS       Microsoft Corp.                         
OS2DAY       Oleg Titov                              
OS/2         International Business Machines Corp.   
TODAY        Michael W. Butler                       
TODAY/PC     Patrick Kincaid                         
Windows 95   Microsoft Corp.                         

All other programs are copyright and/or trademarked by their respective author
unless otherwise noted. 
