home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / pday115o.zip / DOC / PDAY_DOC.TXT < prev    next >
Text File  |  1999-03-18  |  12KB  |  350 lines
  1.                         -= Psych0Day documentation =-
  2.  
  3.  
  4.  
  5. Psych0Day version 1.15 
  6. (k) by Andrew Ziem 1997, 1998, 1999
  7.  
  8. Released: 1999-03-18 (Gregorian) 
  9.  
  10.                                    /"With Psych0Day, your days are numbered!"/
  11.  
  12.                    [ Psych0Soft online | Psych0Day online ]
  13.  
  14. Contents
  15.  
  16.  
  17.     * Introduction 
  18.     * License Agreement 
  19.     * Command Line Arguments 
  20.     * Included Files 
  21.     * Redirection 
  22.     * Common Problems: "Load error: no DPMI" 
  23.     * Common Problems: not enough memory using PAT386.EXE under OS/2 
  24.     * Common Problems: "emx not found" 
  25.     * References and Recommended Reading 
  26.     * Distribution 
  27.     * Acknowledgments and Credits 
  28.  
  29. Introduction
  30.  
  31. Psych0Day is a combination of programs dealing with time. It can report what
  32. happened in history, whose birthday it is, astronomical events, religious
  33. happenings and the phase of the moon as well as display the date in a variety
  34. of calender systems. Psych0Day came from from inspiration of several programs
  35. and an article by Robert Anton Wilson (included in this archive). 
  36.  
  37. TODAY has many incarnations. The original was written by Mike Butler in PL/1
  38. on an IBM VM/CMS system. This, in turn, inspired Patrick Kincaid to write
  39. TODAY/PC in Datalight C in July of 1986. OS2DAY, authored by Oleg Titov, is
  40. the OS/2 incarnation that I had been using until I wrote Psych0Day. 
  41.  
  42. License Agreement
  43.  
  44. Psych0Day is hereby released to the public domain. Portions, however, were not
  45. written by me and belong to their respect authors. I believe what's what is
  46. cleary marked. 
  47.  
  48. If you make any neat improvements or modifications, send them to me. At least
  49. drop me a note: I'd like to see how this thing gets around. 
  50.  
  51. Psych0Day is provided `as is.' There is no warranty of any kind-- expresed,
  52. implied or otherwise. If it breaks, you keep both pieces. 
  53.  
  54. Furthermore, the accuracy of this program is not guaranteed. 
  55.  
  56. Command Line Arguments
  57.  
  58. These can also be listed by running *PDAY ?*. The command line is case
  59. insensitive. 
  60.  
  61.  
  62.   Usage: PDAY [{-|+}c[x]] [-Fdd[mm[yyyy]]] [-i] [{-|+}l[x]]
  63.               [-dir=drive:\\dir\\]
  64.       or PDAY 
  65.  
  66.  
  67. Switches:
  68.  
  69.  
  70.       c: toggle display of calendars (all on by default)
  71.      cd: toggle Discordian
  72.      cf: toggle French Republican
  73.      cg: toggle Gregorian
  74.      ci: toggle Illuminati
  75.      cj: toggle Julian
  76.      cl: toggle Goddess Lunar
  77.      ct: toggle Thelemic (disabled)
  78.       f: force date in the format dd[mm[yyyy]]
  79.       i: display program information
  80.       l: toggle library support (all on by default)
  81.      lb: toggle birthdays
  82.      le: toggle events
  83.      lr: toggle reminders
  84.     lib: specify library directory
  85.  
  86.  
  87. Examples:
  88.  
  89. ex1: PDAY 
  90. Run with all defaults and search current directory for library files. 
  91.  
  92. ex2: PDAY -f09101981 
  93. The date October 9th, E.V. 1981 is used. 
  94.  
  95. ex3: PDAY -f0910 
  96. The date October 9th of the current year is used. 
  97.  
  98. ex4: PDAY -libdir=c:\apps\pday\ 
  99. The directory `c:\apps\pday\' is searched for the library files. Notice that
  100. the trailing backslash is required! 
  101.  
  102. ex5: PDAY -cj -cf 
  103. The Julian and French Republican calendars are disabled. 
  104.  
  105. ex6: PDAY -c +cd 
  106. The calendar displayed is the Discordian. (This neat little trick is possible
  107. because the command line is parsed from left to right.) 
  108.  
  109. ex7: PDAY -l 
  110. Same as ex1 except all no database libraries are displayed. 
  111.  
  112. ex8: PDAY -le -lb 
  113. Same as ex1 except library events and birthdays are disabled. 
  114.  
  115. Included Files
  116.  
  117. If any of these are missing or damaged, see the end of this document for
  118. information on how to get a fresh copy of Psych0Day. 
  119.  
  120.  
  121.  
  122.     PDAY    .EXE     DOS 16-bit executable
  123.     PDAY2   .EXE     OS/2 32-bit executable (requires EMXRT)
  124.     PDAY386 .EXE     DOS 32-bit executlabe (requires DPMI server)
  125.     PDAY95  .EXE     Windows 95 32-bit executable (requires RSXNT.DLL)
  126.  
  127.     PDAY_DOC.HTM     HTML documentation
  128.     PDAY_DOC.TXT     text documentation
  129.     README  .xxx     important notes for version xxx, changes, etc.
  130.  
  131.     RAWTIME .TXT     R.A.W.'s "How to Live Eleven Days in 24 Hours"
  132.  
  133.     CHURCH  .ALL     religious happenings
  134.     MUSIC   .ALL     happenings related to music
  135.     PSYCH0  .ALL     my own general additions
  136.     TODAY   .ZIP     Patrick Kincaid's original TODAY.??? files
  137.  
  138.     SRC     .ZIP     source code; only needed pieces of the packages used
  139.                      have been included as not to waste space
  140.                      ** contains nested subdirectories: use _PKUNZIP -D_
  141.  
  142.     FILE_ID .DIZ     BBS-compatible description
  143.  
  144.  
  145.  
  146. Redirection
  147.  
  148. Psych0Day's output can be redirected (piped) to a file or a device. Below are
  149. several examples of how this done. You may wish to see your system manuals for
  150. more information. 
  151.  
  152. Note: error messages are not piped but instead always sent to the console. 
  153.  
  154. *PDAY > COM1* 
  155. Sends the output to the first communications port. 
  156.  
  157. *PDAY > PRN* 
  158. Data is sent to the default printer. 
  159.  
  160. *PDAY > NUL* 
  161. This is useless considering Psych0Day's function, but the data is sent to the
  162. null device (i.e., oblivion). 
  163.  
  164. *PDAY > c:\bbs\texts\today.asc* 
  165. The file /c:\bbs\texts\today.asc/ is overwritten, if it exists. If it doesn't,
  166. it is created. 
  167.  
  168. *PDAY >> c:\bbs\logs\today.log* 
  169. The file /c:\bbs\logs\today.log/ is appended with Psych0Day's output. If it
  170. doesn't, it is created. 
  171.  
  172. *PDAY | MORE* 
  173. Output is sent to the program /MORE/, which included with many operating
  174. systems. /MORE/ pauses and waits for your input when the page is full. 
  175.  
  176. Common Problems: "Load error: no DPMI" (DOS)
  177.  
  178. The PAT386.EXE requires /DPMI/ (DOS Protected Mode Interface) to access
  179. extended memory. You must either install a DPMI host or use another version. 
  180.  
  181. Available hosts include Windows v3.1, '95 and '98 (in a box running DOS); OS/2
  182. (in the DOS box a.k.a. VDM); QEMM; and CWSDPMI. CWSDPMI is available for free
  183. and works very well. 
  184.  
  185. CWSDPMI from ftp.cdrom.com via FTP 
  186. CWSDPMI from members.xoom.com via HTTP 
  187.  
  188. Common Problems: not enough memory using PAT386.EXE under OS/2
  189.  
  190. In the DOS Settings, set your DPMI_DOS_API to ENABLED (instead of AUTO) and
  191. increase the DPMI_MEMORY_LIMIT to atleast 16 megabytes. 
  192.  
  193. Common Problems: "emx not found" (OS/2)
  194.  
  195. PAT2.EXE requires /the EMX runtime library/ to access certain functions. You
  196. must install the /emxrt/ or use another version. 
  197.  
  198. emxrt from hobbes.nmsu.edu via HTTP 
  199. emxrt from members.xoom.com via HTTP 
  200.  
  201. Common Problems: "rsxnt.dll not found" (Win32)
  202.  
  203. PAT95.EXE requires the RSX runtime library (RSXNT.DLL). 
  204.  
  205. rsxnt.dll from members.xoom.com via HTTP 
  206.  
  207. References and Recommended Reading
  208.  
  209. Title: Calendar Information Page 
  210. Author: Will Linden (wlinden@panix.com) 
  211. URL: http://www.panix.com/~wlinden/calendar.shtml 
  212.  
  213. Today's date in various calendars and eras, celestial and astronomical
  214.    information, and many good links. 
  215.  
  216. Title: Calendar Studies 
  217. Author: Peter Meyer (serendipity@magnet.ch) 
  218. URL: http://www.magnet.ch/serendipity/cal_stud.html 
  219.  
  220. Information covering the Mayan, Goddess Lunar, Gregorian, Julian and other
  221.    lunar calendars. 
  222.  
  223. Title: Celestial Delight: The Best Astronomical Events through 2001 
  224. Authors: Francis Reddy and Greg Walz-Chojnacki 
  225. Publisher: (?) Berkeley California: CelestialArts 
  226.  
  227. Great for novice astronomers. Has history, planet data, and a table of
  228.    events (visable planets, full moons, asteriod showers, etc.) from about
  229.    1990 to 2001 (like the name implies). 
  230.  
  231. Title: Frequently Asked Questions About Calendars 
  232. Author: Claus Tondering (c-t@pip.dknet.dk) 
  233. Included as: CALENDAR.FAQ 
  234. WWW: www.pip.dknet.dk/~pip10160/calendar.html 
  235.  
  236. Contains answers to frequently asked questions about the Christian, Hebrew,
  237.    Islamic, and various historical calendars. 
  238.  
  239. Title: How to Live Eleven Days in 24 Hours 
  240. Author: Robert Anton Wilson 
  241. Included as: RAWTIME.TXT 
  242.  
  243. This is the article inspired me to write Psych0Day. Robert Anton Wilson
  244.    writes of using a "no-bias multi-cultural" calendar. Explained herein are
  245.    11 systems. 
  246.    
  247.    I'd like to know where this was originally published. 
  248.  
  249. Title: Illuminatus! Trilogy 
  250. Authors: Bob Shea and Robert Anton Wilson 
  251. Publisher: Dell Publishing 
  252. URL: http://www.rawilsom.com (R.A. Wilson's web page) 
  253.  
  254. I've finally found one of the books, the third, at a used book store, but I
  255.    haven't started reading because I want it in order. I haven't bought the
  256.    trilogy as one book because it is much abridged. 
  257.  
  258. Title: Principia Discordia 
  259. Author: Malaclypse the Younger 
  260. Publisher: Loompanics Unlimited, Port Townsend, Washington 
  261. Publisher: (or) IllumiNet Press, P.O. Box 2808, Libum, Georgia 30226 
  262. ISBN: 0-9626534-2-X (4th/5th edition) 
  263. WWW: www.informatik.hu-berlin.de/~bach/gwd/principia/body.html 
  264.  
  265. The Discordian Bible wherein is explained absolutely everything worth
  266.    knowing about absolutely anything. 
  267.  
  268. There are many versions floating around. The one I've seen in print is a
  269.    combination of the 4th and 5th editions; the one I have in ASCII is the 5th
  270.    edition; I don't know about the scanned (.GIF) and HTML versions. 
  271.  
  272. Title: SNIPPETS 
  273. F'REQ: *SNIPPETS* from 1:106/2000 or 1:2320/38 
  274. FTP: snippets.org/pub/snippets 
  275. WWW: www.snippets.org 
  276.  
  277. SNIPPETS is a huge collection of C source snippets where I have found many
  278.    a useful thing. I've included the pieces used in this program. 
  279.  
  280. Title: Thelemic Calendar and Holidays 
  281. WWW: http://www5.crl.com/~thelema/calendar.html 
  282. Maintained by: Vere Chappell (thelema@crl.com) 
  283.  
  284. Title: Yahoo! - Reference:Calendars 
  285. URL: http://www.yahoo.com/Reference/Calendars/ 
  286.  
  287. A good starting point for research on the WWW. 
  288.  
  289. Title: Psych0's Bookmark 
  290. URL: http://www.angelfire.com/co/psych0o/links.html#astrology 
  291.  
  292. Where in the World is Psych0?
  293.  
  294. Andrew Ziem is Psych0 and Psych0Soft. 
  295.  
  296. *E-mail* 
  297. psych0o@juno.com 
  298. ziem@iex.net 
  299.  
  300. *Snail* 
  301. 3080 Woodview Ct. 
  302. Colorado Springs, CO 80918-4635 
  303. Colorado Springs, CO 80918-4635 
  304.  
  305. Distribution
  306.  
  307. Look for the latest updates directly from the Psych0Day website. 
  308.  
  309. *File Naming Conventions* 
  310.  
  311. Where xxx signifies the version release: 
  312. all: PDAYxxx.ZIP (DOS, OS/2 and Windows) 
  313. DOS: PDAYxxxD.ZIP (16-bit and 32-bit) 
  314. OS2: PDAYxxxO.ZIP 
  315. W95: PDAYxxxW.ZIP 
  316.  
  317. *WWW* 
  318. http://www.members.xoom.com/sdexter/psoft/ 
  319. http://www.members.xoom.com/sdexter/psoft/pday.html 
  320.  
  321. *Sites* 
  322. Simtel archive 
  323. Hobbes archive 
  324.  
  325. Acknowledgments and Credits (in no particular order)
  326.  
  327. Public domain code from 
  328.     * Bob Stout and Mark Kamradt: COMMAFMT.C; 
  329.     * Bob Stout: DAYNUM.C; 
  330.     * Scott E. Lee: FRENCH.C and JULIAN.C calendars; 
  331.     * Paul Schlyter, Raymond Gardner and Tom Van Flandern: JDN_L.C; 
  332.     * Jim Walsh, Dann Corbit, Bob Stout, and others: L2ROMAN.C; 
  333.     * Peter Meyer: LUNCONV.C; 
  334.     * M. Kimes, Lynn Nash, BSD Unix; 
  335.     * Robert B.Stout: ORD_TEXT.C; 
  336.     * and Ray Gardner: SCALDATE.C. 
  337.  
  338. Portions copyright 1993-1995, Scott E. Lee, all rights reserved. 
  339. DJGPP        DJ Delorie                              
  340. EMX          Eberhart Mattes                         
  341. MS-DOS       Microsoft Corp.                         
  342. OS2DAY       Oleg Titov                              
  343. OS/2         International Business Machines Corp.   
  344. TODAY        Michael W. Butler                       
  345. TODAY/PC     Patrick Kincaid                         
  346. Windows 95   Microsoft Corp.                         
  347.  
  348. All other programs are copyright and/or trademarked by their respective author
  349. unless otherwise noted. 
  350.