home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / EDUCATIO / OTD_11.ZIP / OTD.DOC < prev    next >
Encoding:
Text File  |  1991-04-06  |  32.9 KB  |  1,338 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                       The Software Construction Co.
  23.  
  24.                               Presents ...
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                On This Day
  36.                                Version 1.1
  37.                                April 1991
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                       The Software Construction Co.
  54.                               P.O. Box 160
  55.                        North Billerica, MA  01862
  56.  
  57.   (C) Copyright 1990-1991 The Software Construction Co., All Rights Reserved.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.          1. Introduction                                             1
  65.          2. Command Line                                             2
  66.          3. Databases                                                4
  67.          4. Database format                                          7
  68.          5. Date specifiers                                          8
  69.          6. Notes about calendars                                   11
  70.          7. User Supported Software                                 13
  71.          8. Bug Reports                                             15
  72.          9. Known Problems/Limitations                              16
  73.          Appendices                                                 17
  74.              A. Bibliography                                        17
  75.              B. Program History                                     18
  76.  
  77.  
  78.  
  79.  
  80.  
  81.          On This Day                                       Version 1.1
  82.  
  83.          1. Introduction
  84.  
  85.          Have you ever been curious about events that happened on this
  86.          day in history?  On This Day is a collection of databases and
  87.          a printing interface which will generate a list of items of
  88.          note concerning today.  The databases sent to registered
  89.          users contain more than 11,000 entries (see section 7 for
  90.          more information about registration).
  91.  
  92.          Some of the types of information which may be displayed are:
  93.  
  94.                    - Astronomical events.
  95.  
  96.                    - Birthdays of famous people.
  97.  
  98.                    - Historical events.
  99.  
  100.                    - National observations.
  101.  
  102.                    - Religious holidays and events.
  103.  
  104.          In addition, a personal database may be created to contain
  105.          events important to each specific user.  Events such as
  106.          birthdays of relatives and friends may be appropriate for
  107.          this file.
  108.  
  109.          To clarify, the question this software is intending to answer
  110.          is:
  111.  
  112.          What historical events, religious holidays, etc. happened on
  113.          a particular date?
  114.  
  115.          It is not intended to answer questions like:
  116.  
  117.          What date is Easter next year?
  118.          When was John Wayne born?
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                        1 
  136.  
  137.  
  138.  
  139.  
  140.  
  141.          On This Day                                       Version 1.1
  142.  
  143.          2. Command Line
  144.  
  145.          To run On This Day, use the following command line (note that
  146.          []s enclose optional arguments):
  147.  
  148.                    OTD [-b] [-e] [-p] [-r] [-d <date>]
  149.                        [-m <day-number>|all]
  150.  
  151.                    where:
  152.  
  153.                              b  prints famous birthdays
  154.  
  155.                              d  allows you to specify a date other
  156.                                 than today's date.  Date may be ANY
  157.                                 form specified in section 5, below.
  158.                                 Some may not make sense in actual use
  159.                                 (e.g. R(*) would only print stuff on
  160.                                 Thursdays.)  Note also that only items
  161.                                 that occurred before the date
  162.                                 specified will be printed.
  163.  
  164.                              e  prints today's events
  165.  
  166.                              p  prints today's personal events
  167.  
  168.                              r  prints today's religious events
  169.  
  170.                              m  indicates when to print monthly events
  171.                                 (<day-number> indicates the day each
  172.                                 month.  all indicates to print every
  173.                                 day.) (default: 1)  For example, the
  174.                                 command:  'otd -m 3' will print
  175.                                 today's events and if today is the
  176.                                 third day of the month, it will also
  177.                                 print any existing monthly events. For
  178.                                 more information on monthly events,
  179.                                 see section 5.
  180.  
  181.          Again, we must emphasize that it is NOT necessary to input
  182.          ANY arguments to the OTD command.  Simply typing "OTD"
  183.          (without the quotes, of course) will get you all the output
  184.          in the format that we believe most users want.  If you want
  185.          to alter the output in any way, use the options as described
  186.          above.
  187.  
  188.          Running OTD with none of the b, e, p, or r options is the
  189.          same as running with all the options.  If any of these
  190.          options are specified, only those categories will be
  191.          displayed.
  192.  
  193.  
  194.  
  195.                                        2 
  196.  
  197.  
  198.  
  199.  
  200.  
  201.          On This Day                                       Version 1.1
  202.  
  203.          DOS hints:
  204.  
  205.          Q:     How can I print the output of OTD?
  206.  
  207.          A:     Append '> PRN:' to your command line (e.g. OTD > PRN:
  208.                 will send today's information to the printer).
  209.  
  210.          Q:     It all goes by so quickly ... How do I get it to slow
  211.                 down so I can read it all?
  212.  
  213.          A:     Append '| MORE' to your command line (e.g. OTD | MORE
  214.                 will run OTD, displaying the results one screen at a
  215.                 time).  For more information on the MORE filter, see
  216.                 your DOS manual.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.                                        3 
  256.  
  257.  
  258.  
  259.  
  260.  
  261.          On This Day                                       Version 1.1
  262.  
  263.          3. Databases
  264.  
  265.          On This Day reads it's data from a subset of the following
  266.          databases:
  267.  
  268.  
  269.                    BIRTHDAY.JAN         EVENTS.JAN
  270.                    BIRTHDAY.FEB         EVENTS.FEB
  271.                    BIRTHDAY.MAR         EVENTS.MAR
  272.                    BIRTHDAY.APR         EVENTS.APR
  273.                    BIRTHDAY.MAY         EVENTS.MAY
  274.                    BIRTHDAY.JUN         EVENTS.JUN
  275.                    BIRTHDAY.JUL         EVENTS.JUL
  276.                    BIRTHDAY.AUG         EVENTS.AUG
  277.                    BIRTHDAY.SEP         EVENTS.SEP
  278.                    BIRTHDAY.OCT         EVENTS.OCT
  279.                    BIRTHDAY.NOV         EVENTS.NOV
  280.                    BIRTHDAY.DEC         EVENTS.DEC
  281.                    RELIGION             EVENTS.OTH
  282.                    PERSONAL
  283.  
  284.          Files in the current directory by these names will be used
  285.          first.  If they do not exist there, the environment variable
  286.          OTDDIR will be searched.  It has the same syntax as the PATH
  287.          environment variable.  That is, you could place all the
  288.          BIRTHDAY databases in one subdirectory and all EVENTS
  289.          databases in another specifying all these subdirectories in
  290.          the OTDDIR environment variable.  For example:
  291.  
  292.          SET OTDDIR=C:\OTD\BDAY;C:\OTD\EVT
  293.  
  294.          Or, you might want to place some of the databases on a disk
  295.          in each of two floppy drives on a floppy-only system.  In
  296.          this case, you might want to use the following setting to
  297.          enable OTD to search both places for data:
  298.  
  299.          SET OTDDIR=A:\;B:\
  300.  
  301.          Typically, however, this facility will be used so that the
  302.          OTD command may be invoked from anywhere on your disk and it
  303.          will find the appropriate data files in one directory.  For
  304.          example:
  305.  
  306.          SET OTDDIR=C:\OTD
  307.  
  308.          If the -d option has not been specified, the current date
  309.          from the system clock is used it to determine the extension
  310.          to use in the BIRTHDAY and EVENTS files.
  311.  
  312.          If you set the TZ environment variable, OTD will use that
  313.          value when printing times for astronomical events.  The
  314.  
  315.                                        4 
  316.  
  317.  
  318.  
  319.  
  320.  
  321.          On This Day                                       Version 1.1
  322.  
  323.          syntax of the TZ environment variable is:
  324.  
  325.          SET TZ=zzz[+/-]d[d][lll]
  326.  
  327.          zzz is a three character field representing the name of the
  328.          current time zone (e.g. EST, PST).
  329.  
  330.          [+/-]d[d] is an optionally signed number of one or more
  331.          digits.  It is the local time zone's difference from GMT in
  332.          hours.  Negative numbers adjust westward from GMT. (e.g.
  333.          5=EST, +8=PST, and -1=continental Europe).
  334.  
  335.          lll is an optional three-character field that represents the
  336.          local time zone daylight savings time (e.g. EDT, PDT).  Don't
  337.          include this field if your time zone does not have daylight
  338.          savings time.
  339.  
  340.          If the TZ environment variable isn't present or is not of the
  341.          above form, a default value of EST5EDT will be used.
  342.  
  343.          If birthday information was requested, BIRTHDAY.<mon> will be
  344.          read.  If events were requested, EVENTS.<mon> and EVENTS.OTH
  345.          will be read.  EVENTS.OTH is used for those events which
  346.          might be in different months in different years.  If
  347.          religious events were requested, RELIGION will be read.  If
  348.          personal events were requested, PERSONAL will be read.
  349.  
  350.          The entries will be printed as they are encountered in each
  351.          database.  If you want entries printed in a specific order,
  352.          they must be in that order in the database.
  353.  
  354.          OTD is distributed with all the above databases with the
  355.          exception of PERSONAL.  Note, however, that much larger and
  356.          more extensive databases will be sent to you should you
  357.          register your copy (see section 7 for more information about
  358.          this and other advantages of registration).
  359.  
  360.          Some of the databases distributed with the program are
  361.          compressed.  This helps save disk space upon installation.
  362.          OTD determines dynamically whether a database is compressed
  363.          or not and reads it appropriately.  Upon registration, you
  364.          will also receive the compression and decompression programs
  365.          so that you may maintain the databases that we distribute.
  366.  
  367.          You may, of course, replace any of our compressed databases
  368.          with your own in order to try out some of the features of the
  369.          event specification language.  Or, you may try out
  370.          interesting features in your PERSONAL database without
  371.          touching any of our databases.  The program itself is not
  372.          crippled in any way.  You have the ability to test all
  373.          functionality it is capable of performing.
  374.  
  375.                                        5 
  376.  
  377.  
  378.  
  379.  
  380.  
  381.          On This Day                                       Version 1.1
  382.  
  383.          Note that the information contained in the databases
  384.          distributed with the program has been taken from a great many
  385.          sources since sometime in 1985 or so.  We do not guarantee
  386.          their accuracy.  You may also find duplicate entries which
  387.          are not indicated in the database.  We would appreciate
  388.          hearing about these as we do try to weed out the duplicates
  389.          when and if we can find another source to collaborate one of
  390.          the dates.
  391.  
  392.          We are always interested in new dates.  If possible, please
  393.          try to give us supporting evidence of a new date.  We do not
  394.          want the databases to get any less reliable than they already
  395.          are.  In fact we want them to improve in reliability over
  396.          time.  We do, however, reserve the right not to add any date
  397.          to the database.
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.                                        6 
  436.  
  437.  
  438.  
  439.  
  440.  
  441.          On This Day                                       Version 1.1
  442.  
  443.          4. Database format
  444.  
  445.          A line in the database file may be in one of the following
  446.          forms:
  447.  
  448.                    #:<stuff>
  449.  
  450.                         This line is ignored by OTD.  It is merely
  451.                         used to add commentary to the file.
  452.  
  453.                    <relative date specifier>:<stuff>
  454.  
  455.                         Should today match the relative date
  456.                         specifier, print the stuff to the standard
  457.                         output device.  See section 5 for more
  458.                         detailed information about date specifiers.
  459.  
  460.                    <blanks>:<stuff>
  461.  
  462.                         This type of line indicates a continuation of
  463.                         the line preceding for use when one line won't
  464.                         hold enough text.
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.                                        7 
  496.  
  497.  
  498.  
  499.  
  500.  
  501.          On This Day                                       Version 1.1
  502.  
  503.          5. Date specifiers
  504.  
  505.          Date specifiers may have one of the following forms:
  506.  
  507.          Absolute Dates -
  508.  
  509.                    <month-number>
  510.  
  511.                         If this month (in the specified calendar)
  512.                         matches <month-number> and the -m option
  513.                         specifies today as the print day, print the
  514.                         item.
  515.  
  516.                    <month-number>/<day>
  517.  
  518.                         If this month (in the specified calendar)
  519.                         matches <month-number> and this day matches
  520.                         <day>, print the item.
  521.  
  522.                    <month-number>/<day>/<year>
  523.  
  524.                         If this month (in the specified calendar)
  525.                         matches <month-number> and this day matches
  526.                         <day>, print the item with "In <year>,"
  527.                         prepended.
  528.  
  529.          Relative dates -
  530.  
  531.                    <alternate calendar><absolute date>
  532.  
  533.                         This form directs OTD to use the specified
  534.                         calendar to evaluate <absolute date>.  Valid
  535.                         <alternate calendar>s are:
  536.  
  537.                              G or <none> Gregorian
  538.                              H           Hebrew
  539.                              HF          Hebrew Fast Day
  540.                                          (will be moved to following
  541.                                           day if it is Saturday)
  542.                              I           Islamic
  543.                              J           Julian
  544.  
  545.                         See section 6 for short descriptions of these
  546.                         calendars.
  547.  
  548.                    <absolute date>+<days>
  549.  
  550.                         Add <days> to the date specified in <absolute
  551.                         date>.  For example, 1/3+37 is the same as
  552.                         2/9.
  553.  
  554.  
  555.                                        8 
  556.  
  557.  
  558.  
  559.  
  560.  
  561.          On This Day                                       Version 1.1
  562.  
  563.                    <absolute date>-<days>
  564.  
  565.                         Subtract <days> from the date specified in
  566.                         <absolute date>.  For example, 1/3-21 is the
  567.                         same as 12/13.
  568.  
  569.                    <wkday>(<month>/<day>)
  570.  
  571.                         This specifies the first <wkday> occurring on
  572.                         or before the date specified by <month> and
  573.                         <day>.  Valid values for <wkday> are:
  574.  
  575.                              M          Monday
  576.                              T          Tuesday
  577.                              W          Wednesday
  578.                              R          thuRsday
  579.                              F          Friday
  580.                              S          Saturday
  581.                              U          sUnday
  582.  
  583.                         For example, W(8/14) specifies the second
  584.                         Wednesday occurring in the month of August.
  585.  
  586.                    <wkday>(*)
  587.  
  588.                         This denotes every day that happens to fall on
  589.                         the specified <wkday>.  Valid values for
  590.                         <wkday> are:
  591.  
  592.                              M          Monday
  593.                              T          Tuesday
  594.                              W          Wednesday
  595.                              R          thuRsday
  596.                              F          Friday
  597.                              S          Saturday
  598.                              U          sUnday
  599.  
  600.                         For example, M(*) specifies every Monday.
  601.  
  602.                    E
  603.  
  604.                         This denotes the Christian holiday Easter.
  605.  
  606.                    E+<days>
  607.  
  608.                         This denotes a date <days> days following the
  609.                         Christian holiday Easter.  This format is
  610.                         necessary to specify all the Christian
  611.                         holidays as many are based upon Easter's date.
  612.  
  613.  
  614.  
  615.                                        9 
  616.  
  617.  
  618.  
  619.  
  620.  
  621.          On This Day                                       Version 1.1
  622.  
  623.                    E-<days>
  624.  
  625.                         This denotes a date <days> days before the
  626.                         Christian holiday Easter.  This format is
  627.                         necessary to specify all the Christian
  628.                         holidays as many are based upon Easter's date.
  629.  
  630.                    *
  631.  
  632.                         This denotes every day.
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.                                       10 
  676.  
  677.  
  678.  
  679.  
  680.  
  681.          On This Day                                       Version 1.1
  682.  
  683.          6. Notes about calendars
  684.  
  685.          Gregorian calendar
  686.  
  687.                 This calendar is the one in use currently by much of
  688.                 the world (including the United States).  It was
  689.                 designed by a commission assembled by Pope Gregory
  690.                 XIII in the sixteenth century.  It is based on the
  691.                 revolution of the earth about the sun.
  692.  
  693.                 The months and corresponding numbers that are legal
  694.                 for this calendar are:
  695.                 January         1
  696.                 February        2
  697.                 March           3
  698.                 April           4
  699.                 May             5
  700.                 June            6
  701.                 July            7
  702.                 August          8
  703.                 September       9
  704.                 October         10
  705.                 November        11
  706.                 December        12
  707.  
  708.          Hebrew calendar
  709.  
  710.                 This calendar was placed in operation in the mid-
  711.                 fourth century by Hillel II.  It is based on the
  712.                 moon's revolution about the earth.  However, it has
  713.                 solar corrections built in.
  714.  
  715.                 The months and corresponding numbers that are legal
  716.                 for this calendar are:
  717.  
  718.                 Nisan   1
  719.                 Iyyar   2
  720.                 Sivan   3
  721.                 Tammuz  4
  722.                 Av      5
  723.                 Elul    6
  724.                 Tishri  7
  725.                 Heshvan 8
  726.                 Kislev  9
  727.                 Teveth  10
  728.                 Shevat  11
  729.                 Adar    12
  730.                 Adar II 13 {Note Adar is Adar I in years when
  731.                             there is an Adar II}
  732.  
  733.  
  734.  
  735.                                       11 
  736.  
  737.  
  738.  
  739.  
  740.  
  741.          On This Day                                       Version 1.1
  742.  
  743.                 Certain holidays (fast days) must be moved to the
  744.                 following day (Sunday) if they fall on a Saturday.
  745.                 The HF calendar specifier allows you to indicate a
  746.                 Hebrew date is one of these "special" holidays.
  747.  
  748.                 Note that one holiday (Ta'anit Esther) occurs on the
  749.                 preceding Thursday when Purim is on a Sunday.  There
  750.                 is no way, currently, to specify this relationship.
  751.  
  752.          Islamic calendar
  753.  
  754.                 This calendar is based upon the moon revolving around
  755.                 the earth.  There are no dates in this calendar before
  756.                 Friday, July 16, 622 (Julian)
  757.  
  758.                 Much of the Islamic world does not agree with
  759.                 calculations to determine this calendar at all.  They
  760.                 only rely on proclamation of the new moon by the
  761.                 authorities at al-Azhar in Cairo to define the
  762.                 calendar.  Consequently, the dates computed here may
  763.                 differ by a day or two from those observed by much of
  764.                 the Islamic population of the world.
  765.  
  766.                 The months and corresponding numbers that are legal
  767.                 for this calendar are:
  768.  
  769.                 Muharram        1
  770.                 Safar           2
  771.                 Rabi I          3
  772.                 Rabi II         4
  773.                 Jumada I        5
  774.                 Jumada II       6
  775.                 Rajab           7
  776.                 Sha'ban         8
  777.                 Ramadan         9
  778.                 Shawwal         10
  779.                 Dhu al-Qada     11
  780.                 Dhu al-Hijjah   12
  781.  
  782.          Julian calendar
  783.  
  784.                 This calendar was instituted in 45 BC by Julius
  785.                 Caesar.  It, too, is based on the revolution of the
  786.                 earth about the sun.
  787.  
  788.                 The months for the Julian calendar are the same as
  789.                 those used for the Gregorian calendar.  See above for
  790.                 more information on the proper month numbers to use
  791.                 when constructing dates.
  792.  
  793.  
  794.  
  795.                                       12 
  796.  
  797.  
  798.  
  799.  
  800.  
  801.          On This Day                                       Version 1.1
  802.  
  803.          7. User Supported Software
  804.  
  805.          This software is distributed through a unique marketing
  806.          approach called Shareware.  What this means is that we
  807.          encourage you to copy this software distribution and share it
  808.          with your friends.  We must make the stipulation, however
  809.          that you not modify the distribution in any way when you do
  810.          share it.
  811.  
  812.          If you have received this software through one of the so
  813.          called "Shareware Houses" (companies whose business is
  814.          selling disks containing other author's software), please
  815.          note that none of the money you have paid so far has (or
  816.          will) make its way to the author.  You have simply paid for
  817.          the duplication and distribution costs.
  818.  
  819.          This method of distribution is based on the following
  820.          principles:
  821.  
  822.                    1.   Users need to try out software to determine
  823.                         its usefulness.
  824.  
  825.                    2.   Authors of software can get support directly
  826.                         from their users.
  827.  
  828.                    3.   Software sharing and copying can/should be
  829.                         encouraged.
  830.  
  831.          If you use this software, we ask that you register your copy.
  832.          For your $25 registration fee, you'll receive the benefits
  833.          listed below.  You may use the registration form on the last
  834.          page of this manual to forward the necessary information to
  835.          us.
  836.  
  837.          Registration benefits include:
  838.  
  839.                    - Notification of any updates.
  840.  
  841.                    - The latest version of the software.
  842.  
  843.                    - A much more extensive collection of data.
  844.  
  845.                    - The compression and decompression programs.
  846.  
  847.                    - Several other utilities which make the
  848.                      maintenance of the databases much easier.
  849.  
  850.          Although we encourage copying and sharing of On This Day to
  851.          distribute our product, we must insist that you NOT share the
  852.          utilities, compression/decompression programs, and larger
  853.          databases you will receive upon registration.  We retain full
  854.  
  855.                                       13 
  856.  
  857.  
  858.  
  859.  
  860.  
  861.          On This Day                                       Version 1.1
  862.  
  863.          copyrights to these files.  It is an infringement of
  864.          copyright law to distribute copies of these files.
  865.  
  866.          Please send your registration fee to:
  867.  
  868.                           The Software Construction Co.
  869.                                  P.O. Box 160
  870.                            North Billerica, MA   01862
  871.  
  872.          If you do not use this software, we'd also like to know why.
  873.          It is obvious you're somewhat interested or you wouldn't have
  874.          gotten this far into the manual.  We'd like to know how we
  875.          can make this product better.  Please write to us at the same
  876.          address and let us know what we could have done to make them
  877.          useful to you.
  878.  
  879.          For $5 to cover the cost of the diskette(s) and shipping, we
  880.          will supply you with the latest edition of the software.
  881.          Please specify if you'd like 5.25" or 3.5" diskettes.
  882.  
  883.          We would sincerely like to thank you for giving this, the
  884.          fruits of our labor, a trial.  We hope it proves useful to
  885.          you.
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.                                       14 
  916.  
  917.  
  918.  
  919.  
  920.  
  921.          On This Day                                       Version 1.1
  922.  
  923.          8. Bug Reports
  924.  
  925.          Should you discover a bug in this code, please let us know at
  926.          the same address listed in section 7.  We regret that we
  927.          can't provide phone support at this time (maybe in the
  928.          future).  Provide us with as much of a description of the
  929.          problem as you can, as well as your name and address.  If you
  930.          would prefer being contacted by phone, by all means, add your
  931.          phone number and the hours you will be available at that
  932.          number.
  933.  
  934.          What do you get for your trouble?  We will send a copy of the
  935.          fixed program to the first registered user to report the
  936.          problem and will strive to answer all others with a letter.
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.                                       15 
  976.  
  977.  
  978.  
  979.  
  980.  
  981.          On This Day                                       Version 1.1
  982.  
  983.          9. Known Problems/Limitations
  984.  
  985.          a.     The Jewish holiday Ta'anit Esther occurs on the
  986.                 preceding Thursday when Purim falls on Sunday.  There
  987.                 is no way, currently, to indicate this relationship.
  988.                 We are not sure that this functionality will ever be
  989.                 included as this relationship is extraordinarily rare.
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.                                       16 
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.          On This Day                                       Version 1.1
  1042.  
  1043.          A. Bibliography
  1044.  
  1045.          Special thanks to John Peyton, a friend who helped get me
  1046.          thinking along the right path several times.
  1047.  
  1048.          Following is a list (no doubt partial) of items I found
  1049.          helpful when learning how to calculate the various calendars,
  1050.          astronomical events, etc. that are contained in the software:
  1051.  
  1052.          Astronomical Formulae for Calculators by Jean Meeus, 1982,
  1053.                 Willmann-Bell, Inc.
  1054.  
  1055.          Calendrical Calculations by Edward M. Reingold and Nachum
  1056.                 Dershowitz, 1989, University of Illinois at Urbana-
  1057.                 Champaign.
  1058.  
  1059.          Practical Astronomy With Your Calculator by Peter Duffett-
  1060.                 Smith, 3rd edition 1988, Cambridge University Press.
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.                                       17 
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.          On This Day                                       Version 1.1
  1102.  
  1103.          B. Program History
  1104.  
  1105.          Version 1.0 - April 1990.
  1106.  
  1107.          Version 1.1 - April 1991.
  1108.  
  1109.                 - Phases of the moon added.
  1110.  
  1111.                 - Lunar eclipses added.
  1112.  
  1113.                 - Compression for databases.
  1114.  
  1115.                 - Serial numbers to track distribution better.
  1116.  
  1117.                 - TZ environment variable controls times for
  1118.                   astronomical events.
  1119.  
  1120.                 - A few minor bug fixes.
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.                                       18 
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.    - A -
  1163.  
  1164.          absolute dates                 <see dates, absolute>
  1165.          address                        14, 15
  1166.          alternate date specification   2
  1167.          astronomical events            <see events, astronomical>
  1168.  
  1169.    - B -
  1170.  
  1171.          birthdays                      1, 2, 5
  1172.          bugs                           15
  1173.  
  1174.    - C -
  1175.  
  1176.          calendar, Gregorian            8, 11
  1177.          calendar, Hebrew               8, 11
  1178.          calendar, Islamic              8, 12
  1179.          calendar, Julian               8, 12
  1180.          calendars                      11
  1181.          command line                   2
  1182.          command line options           2
  1183.          comments                       7
  1184.          compression                    5
  1185.          continuation lines             7
  1186.  
  1187.    - D -
  1188.  
  1189.          database format                7
  1190.          databases                      4
  1191.          date specifiers                8
  1192.          dates, absolute                8
  1193.          dates, relative                8
  1194.          decompression                  5
  1195.  
  1196.    - E -
  1197.  
  1198.          Easter                         9
  1199.          events                         2, 5
  1200.          events, astronomical           1
  1201.          events, historical             1
  1202.          events, monthly                2
  1203.          events, personal               2, 5
  1204.          events, religious              1, 2, 5
  1205.  
  1206.    - G -
  1207.  
  1208.          Gregorian calendar             <see calendar, Gregorian>
  1209.  
  1210.    - H -
  1211.  
  1212.          Hebrew calendar                <see calendar, Hebrew>
  1213.          Hillel II                      11
  1214.          historical events              <see events, historical>
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.    - I -
  1222.  
  1223.          introduction                   1
  1224.          Islamic calendar               <see calendar, Islamic>
  1225.  
  1226.    - J -
  1227.  
  1228.          Julian calendar                <see calendar, Julian>
  1229.          Julius Caesar                  12
  1230.  
  1231.    - L -
  1232.  
  1233.          limitations                    16
  1234.  
  1235.    - M -
  1236.  
  1237.          monthly events                 <see events, monthly>
  1238.  
  1239.    - N -
  1240.  
  1241.          national observances           1
  1242.  
  1243.    - O -
  1244.  
  1245.          options, command line          <see command line options>
  1246.          OTDDIR environment variable    4
  1247.  
  1248.    - P -
  1249.  
  1250.          PATH environment variable      4
  1251.          personal events                <see events, personal>
  1252.          Pope Gregory XIII              11
  1253.          problems                       15
  1254.          problems, known                16
  1255.  
  1256.    - R -
  1257.  
  1258.          registration information       5
  1259.          relative dates                 <see dates, relative>
  1260.          religious events               <see events, religious>
  1261.          religious holidays             <see events, religious>
  1262.          reporting bugs                 15
  1263.  
  1264.    - S -
  1265.  
  1266.          shareware                      13
  1267.  
  1268.    - T -
  1269.  
  1270.          time zone                      <see TZ environment variable>
  1271.          TZ environment variable        4
  1272.  
  1273.    - U -
  1274.  
  1275.          user supported software        <see shareware>
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.    - Misc -
  1282.  
  1283.          -m option                      8
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.                           The Software Construction Co.
  1300.                                   P.O. Box 160
  1301.                            North Billerica, MA  01862
  1302.  
  1303.         Name:    ________________________________________________________
  1304.  
  1305.         Address: ________________________________________________________
  1306.  
  1307.                  ________________________________________________________
  1308.  
  1309.                  ________________________________________________________
  1310.  
  1311.         Phone:   ________________________________________________________
  1312.  
  1313.         Where did you get your copy of On This Day (version 1.1)?
  1314.  
  1315.         The Software Construction Co. _____        BBS              _____
  1316.  
  1317.         Friend                        _____        Shareware Dealer _____
  1318.  
  1319.         If you checked BBS or Shareware Dealer above please tell us which
  1320.         one:
  1321.  
  1322.         _________________________________________________________________
  1323.  
  1324.         What format media would you like?         5.25" _____  3.5" _____
  1325.  
  1326.         Comments or suggestions: ________________________________________
  1327.  
  1328.         _________________________________________________________________
  1329.  
  1330.         _________________________________________________________________
  1331.  
  1332.         _________________________________________________________________
  1333.  
  1334.         _________________________________________________________________
  1335.  
  1336.         _________________________________________________________________
  1337.  
  1338.